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The ComfilePi is a touch panel PC designed with high-tolerant components and no moving 
parts for industrial applications. It features a water-resistant front panel, touchscreen, 
color LCD (available in various sizes), RS-232, RS-485, Ethernet, USB, I2C, SPI, digital 1O, 

battery-backed RTC (real-time clock), and piezo buzzer. 


Use the rear-panel 40-pin GPIO header to expand its features and capabilities with additional 
I/O boards. The ComfilePi is UL Listed and employs Raspberry Pi Compute Module. 
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WELCOME 
to The MagP1 127 


very March we ask the Raspberry Pi community to 
= join us in our #MonthOfMaking (page 68). This year, 

Rob has asked some of the biggest names in the maker 
community for advice on building incredible things with 
computers. The result is a wonderful feature that is packed 


Lucy 
with advice. Hattersley 
Armed with a little knowledge, your Raspberry Pi can Lucy is the editor 
become lots of big things! This month, the team also shared arene 
50 Hacks & Hints (page 34). These are our favourite tips for Dea aut 
making with small computers, and they will make a huge ae 
difference to your builds. magpi.ce 


This issue is packed with the best builds, expert advice, 
and enough inspiration to get you determined to make that 
project. Don’t forget to show us what you make. 


Lucy Hattersley Editor 
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TCP/IP Offload Ethernet 


Design Contest 


e Supporting up to 80 Mbps Speed 


¢ Targeting High Performance 
Applications 


USE W5300 


¢ 8/16 bit Data Bus Interface (Direct & Indirect Address Mode) aS Contest Mar 16 
; Li begins 
¢ High Network Performance : Max 80Mbps (by DMA) 
¢ 8 Independent hardware sockets 
Vw 
Special price Mar 16 


at WiZneteshop ~ April 30 


Buy 


NZ 
W5300($5) or W5300 TOE Shield($10) © : 
at WiZnet e-shop W5300 W5300 TOE Shield spealiscions feo 
VV 
e) : 
Winners 
(i | announced by July 18 


1st PRIZE 2nd PRIZE Srd PRIZE 
$5,000 »& $2,500 $ 1,000 : 


at maker.wiznet.io 
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DEBUG PROBE 


DISCLAIMER: Some of the tools and techniques shown in The MagPi magazine are dangerous unles 


ised with skill, experience, and appropriate personal protection equipment. While 
e for your own safety and un tanding the limits of yourself and your equipment. Children should be supervised. Raspberry 
oO equipment, or costs incurred from projects, tutorials or suggestions in The MagPi magazine. Laws and regulations covering 
en countries, and are always subject to change. You are responsible for understanding the requirements in your jurisdiction 
s place limits on the use of their hardware which some projects or suggestions in The MagPi magazine may go beyond. It is 


we attempt to guide the reader, ultimately you are responsi 
Pi Ltd does not accept responsibility for any injuries, damag 
many of the topics in The MagPi magazine are different be 
and ensuring that you comply with them. Some manufacture 
your responsibility to understand the manufacturer's limits. 
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STARTS HERE 


From genuine, manufacturer-warrantied components to es 
millions of in-stock parts shipped same day, be confident 
Digi-Key will get you what you need—when you need it. 


Digi-k ELECTRONICS 


Digi-Key is a franchised distributor for all supplier partners. New products added daily. Digi-Key and Digi-Key Electronics are registered trademarks of Digi-Key Electronics in the U.S. and 
Hie 


Visit © 9) ey.co.« today, or call 0800 587 0991. 


other countries. © 2023 Digi-Key Electronics, 701 Brooks Ave. South, Thief River Falls, MN 56701, USA 
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Raspberry P1 
Debug Probe 


Bridging the gap between non-Raspberry Pi computers and Raspberry Pi Pico 


aspberry Pi Debug Probe is a new USB Increasing compatibility 
@ Device designed to enable debugging of Debug Probe is compatible with the CMSIS-DAP 
Raspberry Pi Pico, and other Arm-based standard (magpi.cc/cmsisdap) and works with 
microcontrollers, with a non-Raspberry Pi OpenOCD (openocd.org) and other tools that 
computer (that lacks GPIO pins). support CMSIS-DAP. 

Resembling a tiny Raspberry Pi inside a clear Raspberry Pi Debug Probe is designed to make it 
plastic case, the probe has a USB connection to easy to use a Raspberry Pi Pico on platforms such 
your computer on one side and two JST as Windows, Mac, and Linux-based computers. On 
connections on the other. The probe is designed these machines, you are unlikely to have a GPIO 
for easy, solderless, plug-and-play debugging. header to connect to Pico’s serial UART or SWD 
It features a USB to Arm Serial Wire port. Debug Probe acts as a bridge between 
Debug (SWD) port and USB to the two devices. 

UART bridge. > Raspberry Pi Debug Probe ($12, 


magpi.cc/debugprobe) is 
available now from official 
Raspberry Pi resellers. 


Raspberry Pi 
Debug Probe looks 
stylish in its small 
Raspberry Pi case 
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The USB cable connects 
Raspberry Pi Debug 
Probe to your computer 


The UART Serial connection 
is wired directly to the GPIO 
pins on Raspberry Pi Pico 


These two JST Connectors are The SWD Debug port 
used to connect Raspberry Pi found on Raspberry 
Debug Probe to Raspberry Pi Pico Pi Pico H (and WH) 


M Raspberry Pi Debug Probe is designed to 
make it easy to use a Raspberry Pi Pico 
on platforms such as Windows, Mac, and 
Linux-based computers @ 
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A Raspberry Pi Debug 
Probe comes with all 
the cables you need 

the board itself. to connect to either 

Here we can see the male/female pin 

UART and Debug headers or the SWD 

JST connections Debug port 


@ Inside the case sits 
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Desert Eye 


2.0 


A sophisticated Raspberry Pi 4 robot that 
observes terrain for danger could save human 
lives, maker Aviv tells Rosie Hattersley 


Aviv Butvinik 


New York-based 
Aviv loves designing 
robots and has 
turned this passion 
into a career as an 
industrial designer 
and engineer. 


magpi.cc/ 
deserteyerobotics 


unforgiving sands of the desert in the 

darkness of night, covering many miles 
at a time and stopping at given waypoints to 
surveil. It could collect video at these stop- 
points from a front-mounted controllable zoom 
camera equipped with infrared LEDs invisible 
to the naked eye, but illuminating for camera 
visibility. Then, it could beam this video data over 
an encrypted wirelessly connection to a distant 
location. Possible dangers surveilled, soldiers or 
explorers would be briefed on whether it was safe 
to proceed, potentially saving lives as well as time 
and money. This is the concept robot enthusiast 
and engineer Aviv Butvinik has been working on 
over the past two years. In December, he unveiled 
the second iteration of his Desert Eye surveillance 
robot with a YouTube video that shows off its 
ability to cope with harsh environments replete 
with sandstorms: magpi.cc/deserteyeyt. 

Desert Eye is also a great showcase for 
Raspberry Pi 4, which Aviv chose for its video 
processing capabilities - “a large consideration 
in this robot” — as well as controlling its motion 
and communications. Aside from the cameras, 
Raspberry Pi 4 controls the two main DC motors, 
a stepper motor so the camera can rotate 
while being stabilised, the GPS and wireless 
connectivity, and a three-axis sensor and fan. 


[ magine a robot that could traverse the 
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» 


Placement of the video 


camera and the infrared 
LEDs either side to avoid 
washed out images 
meant sacrificing some 
of the field of vision 


Grand designs 

Aviv had the sort of early school encouragement 
most of us can only dream of, getting to build 
model rockets, foam boats, and motorised balsa 
wood cars with his elementary school science 
teacher. “Those years instilled in me a love for 
science,” he says. Aviv’s father suggested he 
apply for the industrial design degree at the local 
university, where he eventually found his niche 
with a proposal for an engineering project that 
bagged him first place at the Design for Safety 
Symposium. This success led to Aviv taking up 


Raspberry Pi 4 controls the 
camera, sensors, GPS, and 
motors, as well as sending 
surveillance images wirelessly 
to the robot operator 


A taut electric belt with extra 
rocker arm ensures Desert Eye can 
move efficiently over all terrains 


CTS 


>» When designing 
a robot, Aviv 
suggests having “a 
grand vision". 


Envisage “the 


oy “i Be fyts ; 3 hardest ‘mission’ 


TAS LEE oO RET PE 
inet moe asc Ae a . ee) < it would need 


ls on 


lm The VIAM team spent 
many hours helping 
Aviv get Desert Eye's 
programming just right @ 


a post as a mechanical engineer and industrial 
designer creating automotive safety products. He 
says the project challenges, and solutions he’s 
exposed to make him think about “the physical 


forces, electrical engineering, and kinematics 
involved in designs.” 

Aviv’s passion for robotics saw him design 
almost every aspect of Desert Eye himself, 
including the suspension dynamics, which he 
carried over from the first design to the current 
version. In an ideal world, he would have designed 
his own fasteners, motors, and even his own take 
on Raspberry Pi 4. Aviv sourced components from 
a range of online sources and used a 3D printing 
shop, but his best tip is to use VIAM open-source 
robot control software (viam.com), which he 


to undertake" 


Desert Eye 
originally had 
two bike chain- 
like loops 


These were 
connected with 100 
3D-printed links to 
create a belt.. 


> But were incredibly 
time-consuming 
to assemble 
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C AMERA CHIP 


STEER MoT ott 


Sterret 
Mook 


& Aviv starts with a “grand vision” of what he wants his robots to favours for the online platform’s ease of use, and 

be able to do - and sketches out how it will work i 

because Raspberry Pi can be flashed with a Lite 

version of the OS for the VIAM server, increasing 
its processing speed. “The VIAM team spent many 
hours helping me get Desert Eye’s programming 
just right and I hope to work with them again in 
the future on some of the more advanced visions I 
have for the robot.” 

While Aviv was confident about 
Raspberry Pi 4 being powerful 
enough to process the video 
camera footage his surveillance 
robot captured, the infrared 

LEDs either side of the camera 
module had a tendency to wash 
out the footage. Moving them 

further away from the camera and 
angling them away from the ground 

so the light beams were narrower and 
a foot in front of the robot was a simple 
but effective fix. 


4 STL files can be 
downloaded if you'd like 
to build your own robot 
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4 Aviv shows off his 


completed Desert Eye 2.0 Go go robot! 


robot, as featured on the 
cover of Servo magazine 


DesertEyeRobotics.com details the hardware 
01 needed to create your own surveillance robot, 
along with CAD STL files. You need a Raspberry Pi 4, 
two DC motors, stepper motor, jumper wires, and a 
motor controller - and, optionally, a Desert Eye PCB. 


. eh. 
as 


02 Complete construction and house it ina 
suitable chassis, then download and install 
the VIAM control software: magpi.cc/viamsetup. 


Iterate and improve A Desert Eye 2.0 spotted on The VIAM app (app.viam.com) is used to connect 
manoeuvres in the wild and control the robot. It also has links to the 


5 ; 
Many of the challenges for Desert Eye’s design documentation for more detailed instructions. 


relate to its locomotion. The first version of the 
robot had an overly complex belt loop and dual 
sprocket system that drove the tank forward. “It 
looked and worked a lot like the suspension on 
a standard tank,” says Aviv, but the belts would 
sometimes fall off their sprockets due to road 
vibration. Aviv has replaced these with a lighter, 
3D-printed flexible belt loop made from elastic 
that can tolerate much higher degrees of vibration 
and misalignment than chains. 

Aviv also found that when the robot started 
up, there was “a huge drop in belt tension (extra installed VIAM, press the button on the PCB to 
slack), as the rockers all moved inwards.” He fixed turn the robot on. It will connect automatically to the 
this by adding a second rocker arm to the back VIAM server, ready for you to control your robot. 
rocker to compensate for the loss of tension. HI 


03 Once you've connected everything and 
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It's time to make some noise as Carter Hurd strips a Bluetooth speaker 
dnd turns it into a miniature computer, as David Crookes explains 


Carter Hurd 


Carter is an 
artist, inventor, 
and automotive 
sensing engineer 
who runs a small 
YouTube channel 
documenting 

PC and robotics 
projects. 


4 magpi.cc Mini PC 


hen Carter Hurd was approached by a 

company and asked to review one of its 

products, he accepted on one condition: 
that he wouldn’t actually review it, but instead 
pull it apart. Given Carter is an engineer and 
inventor, this was perhaps to be expected. 

The result was a Bluetooth speaker that 
ended up being turned into an attractive 
miniature PC, powered by a Raspberry Pi 
computer (magpi.cc/minipc). 

“T have a YouTube channel (magpi.cc/carteryt), 
and a company called Divoom sent me a 
Bluetooth speaker to review,” Carter explains. 
“Unfortunately, I’m not a product reviewer, so I 
decided to make a project with it. Initially, I was 
hoping to make a standalone music and media 
player for my kitchen but, as I got further along, 

I realised that I’d need to remove the speaker if I 
wanted to fit in a display.” 

The item Carter received was the Divoom Ditoo 
Plus Retro Pixel Art Game Bluetooth Speaker. It’s 
a curious little thing that’s styled to look like 
a desktop PC and, as well as six buttons and a 
tiny stick to navigate its many features, it has a 
screen which allows users to display pixel art, play 
games, or view information. 


Key to success 

To turn this device into a PC, however, the 
buttons, the screen, and the speaker needed to be 
stripped away. Carter grabbed cutting tools and a 
screwdriver and began disassembling, eventually 
eaving just the case. He then began inserting new 
hardware, starting with a replacement keyboard. 
He happened to have a USB BlackBerry Q20 
keyboard with trackpad to hand, and this fitted 
neatly once he trimmed the corners. 

“Tt was simply luck that the keyboard I had on 
hand was such a good fit,” he says, explaining that 


The Raspberry Pi 
computer fits into the case 
beneath the BlackBerry 
keyboard. You can just see 
the wiring peeking out 


he hid the rough edges and the surrounding board 
by 3D-printing a bezel. Unfortunately, the display 
proved trickier. “The screen I had was not a good 
fit,” he laments. “Although being square was a 
good start, the glass was too large to fit within the 
speaker housing. 

“T cut the glass with shears and covered the 
edge shards with a 3D-printed bezel. But cutting 
electronics with shears is a bit of an inside joke 
on my YouTube channel. It’s dumb and it’s not a 
method I recommend. To make the display look 
more like a CRT, I also shaped a piece of thermal 


Ah 
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The Mini PC fits 
inside a retro 
speaker case 


a Vacuum form 


plastic gives the 
display a CRT look 


The casing is large 
enough to fit 

a four-inch square 
720x720 display, 
but Carter trimmed 
the corners away 


It uses a Raspberry 
Pi 3B computer 


But a Raspberry Pi 
Zero would have 
worked better 


The finishing 
touches were 
3D-printed 


The Mini PC is housed 
in a retro Bluetooth 

speaker case with the 
addition of 3D-printed 
bezels and covers 


_ = 


It was simply luck that the 
keyboard | had on hand 


was such ag good fit 


plastic into a dome with a hair-dryer and placed it 
over the LCD.” 

. "¢: The Mini PC is so 
Making sacrifices small, it can sit on the 
The final step was to fit a Raspberry Pi 3B palmar your Rand) But 


. ; . it meant the internal 
computer. Again, it needed to squeeze into the “ space was tight 
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4 Raspberry Pi OS is 
capable of being 
displayed on the 
square screen and it 
can be controlled by 
the keyboard 
and trackpad 


w The display got in 
the way of the newly 
fitted keyboard, so 
Carter created a new 
hinge to allow the 
screen to sit higher 
and tilt back more 


4 Carter says he could 
have connected 
Raspberry Pi to 
the USB-C port and 
on/off button on the 
right-hand side of the 
speaker housing 


> Here is a rear view of 
the device. Carter 
says he would like 
to make the project 
battery-powered 
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Fitting the components 


— #8: 3 “or The BlackBerry keyboard needed some 
= > © brutal trimming of the PCB to ensure it could 
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case and it required removing the GPIO pins to 4 The BlackBerry keyboard 
A : ‘ . fits smartly into the bottom 
fix on a right-angle header. This proved tricky of the casing, surrounded 
and Carter still couldn’t create a sufficiently low by a snug bezel The Raspberry Pi computer fits well inside the 


profile, so he ended up cutting the bottom of the bottom casing, but it still sits rather too high. 


housing instead. “If I was to buy the parts, I would 
have used a Raspberry Pi Zero computer which 
would have fit better,” he says. 

Even so, once assembled, the Mini PC has 
worked a treat. It boots up, displays the familiar 
Raspberry Pi OS screen, and it’s controllable via 
the keyboard. But if Carter worked on it again, he 
says he might do things differently. 

“The bottom cover could be designed better to 
fit over the Raspberry Pi computer, and the upper 
housing could be redesigned to include a speaker,” 
he says. “I could find some way of preserving 
the LCD’s touch sensitivity while still achieving 
the CRT domed look. To be honest, though, I 
haven’t really used it much. I kinda just built it to 
see if I could.” 


The display's corners could be seen beneath 
the bezel, so they were trimmed, but this did 
crack the screen. 
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Proto Shield 
with Robot Arm 
and Snake Game 


Proto Shields usually work with Arduinos, but one maker created a 
Raspberry Pi version for some sneaky gameplay, he tells Rosie Hattersley 


Ronin 


Ronin is an 
embedded systems 
engineer who 
enjoys making 
robots and 
microprocessor- 
based projects. 


github.com/ 
byronin 


Ronin enjoys 
designing and 
manufacturing his 
own boards 


would grow up to be an enthusiastic maker 

and technical engineer came at the age of 
10 when he bought his first soldering iron; at 15 
he built his first mini sumo robot, winning first 
prize in the very first competition he entered. An 
embedded systems engineer in his native Turkey, 
Ronin loves designing his own projects. Although 
his Raspberry Pi Proto Shield and Snake Game is 
his first appearance in The MagPi (and his first Pico 
project), his prodigious output means it’s unlikely 
to be his last. 


T he first indication that Ronin (aka byronin) 
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Ronin built his first prototype circuit board 
six years ago and discovered Raspberry Pi a year 
later. He usually programs microcontrollers using 
embedded C, but learning MicroPython led him to 
Raspberry Pi and, more specifically, the Pico. After 
realising the scope of what Pico can do, Ronin 
says he was “mad at myself” for not buying a 
Raspberry Pi Pico for his workshop before, given 
that every project he works on has buttons, an 
OLED screen, and motors. 


M Ronin built his first 
prototype circuit board six 
years ago and discovered 
Raspberry Pi a year later @ 


Protection measures 

Ronin likes to design and manufacture a bespoke 
shield whenever he buys a new development 
board or a microcontroller, and is now a regular 
customer of custom circuit board printing 
company PCBWay. Most of his project builds are 
based on off-the-shelf or easy-to-acquire parts, 
but PCB production is “a difficult process”, so 
he prefers to rely on a paid-for service. Although 
Raspberry Pi has its own system of HATs as 


Ronin 3D-printed the robot 
arm from an Instructables 

project and set up his Pico 
Proto Shield as a controller 


Pico's copious connection options, 
UART and I2C features made it 
ideal for both robot control and 
the Snake game he installed 


Ronin designed the Pico 
Proto Shield himself, adding 
space on his custom circuit 
board for an OLED screen 


0 


Assembling the 
3D-printed the parts 
for the robot arm, 
ready to use with Pico 
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Ronin adapted Hari 
Wiguna's Pico Snake 


Game to display 


on the OLED on his 


Proto Shield 


magpi.cc 
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PCBWay helped with creating the PCB (printed circuit board) 
production and delivery 


Most project builds are based on off-the-shelf parts, but PCB 
production is a complex process 


Proto Shield with Robot Arm and Snake Game 


well as plenty of ports, a Proto Shield mimics 

the Arduino approach he was used to. Further 
research led Ronin to the idea of learning about 
Pico by making a robot arm - a popular Raspberry 
Pi project, for which he followed GHIZmo’s 
Instructable: magpi.cc/eezybotarm. Ronin had 
access to a 3D printer to print parts for this. 

He also decided to incorporate an OLED screen 
into his custom Proto Shield, turning his Pico 
into an interactive Snake game as well as a robot 
arm controller. 


He had little experience 
of MicroPython before 
working on his indugural 
Pico project 


Gaming the system 

Quite sensibly, Ronin focused on the elements he 
could do well, namely developing a Proto Shield 
and designing a circuit board, reporting that 
Raspberry Pi’s liberal provision of GPIO pins and 
PWM, UART, and I2C features “provided a lot of 
convenience in the design process of the Proto 
Shield.” He chose Hari Wiguna’s enticing Pico 
Snake game (magpi.cc/picosnakeyt) for its visual 
engagement, but had to write image-to-byte array 
instructions: magpi.cc/imagetobyte. Aside from 


the time taken to order components and print A Soldering the 
components 


parts, the whole thing took less than two days’ into place 

work to assemble and get working. He cheerfully 

admits he had little experience of MicroPython 

before working on his inaugural Pico project, but 

says any coding errors were because he wrote code 

that would have worked in C rather than typing in 

Python commands. 
Responses to the project have been 

overwhelmingly positive, with so many email 

alerts he could barely keep up. Buoyed up by 

the feedback, Ronin is already hard at work 

on a similar project for a mini sumo robot, 

neatly recalling his first steps into robotics as 


a teenager. mM fashion to a HAT 
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V_ Ronin has designed his 
own Proto Shield, which 
allows devices to be 
connected to Raspberry 
Pi Pico in a similar 
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Ronin details the Proto Shield design process 
01 at magpi.cc/picoprotoshield. For simplicity, 
you can send the PCB files to an online service such 
as PCBWay to print it. 


The Proto Shield provides lots of extra options 
02 for attaching components such as motors 
and screens to Raspberry Pi Pico. Test the setup by 
trying out lights and other attachments. 


Raspberry Pi \P 


SO tee ie ld 


V Oa" 6 
{#—~—} Tree — 
03 Install the Snake game code from HariFun's 
GitHub page. The tiny keypad beneath the 


OLED makes for plenty of diverting fun. Next up, 
design your own case, perhaps? 
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Workshop Rudolph 
the Red Nose Reindeer 


How do you get people to start learning programming around Christmas time? 
With Rudolph, of course, Rob Zwetsloot saw it, and even says it glows 


Bas op 
ten Berg 


An expert in data 
analytics who 

now consults on 
electro-mechanical 
prototyping and new 
technologies, all 
while still making. 


botberg.eu 


V_ The parts are wired 
up in an easy to 
understand way - 
and glued down to 
keep them tidy 


in general is a question that the Raspberry 

Pi Foundation has been asking - and 
answering very well! - for over a decade now. 
When Bas op ten Berg was faced with this 
question, he went a slightly different route. 

“The Workshop Rudolph The Red Nose Reindeer 
is a low-entry approach in starting learning to 
program Python with Raspberry Pi Pico,” Bas 
explains. “I created this workshop when I was 
requested for opportunities to entertain a team of 
non-technical colleges, and get them enthusiastic 
with a positive programming experience.” 

Specifically, Rudolph uses MicroPython. Bas 
was “astonished” by how quick and simple it was 
to create scripts for Pico and get them running, 
which seemingly served as inspiration for his 
programming experience. 

“T foresaw a big blinking LED as a red nose, 
an animated leg (actuated by a simple servo), a 


[- ow to start with Python or programming 
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turning star connected to a potentiometer, and 
lots of blinking lights to support the Christmas 
theme,” Bas says. “Simple, versatile to support 
users in programming their individual scenes, 
simple to connect by USB, and easy to update and 
modify with Thonny. Besides all of this, Pico was 
available at an attractive price.” 


Very shiny nose 

While drafting up the project, Bas made 

several examples using LEDs, servos, speakers, 
illustrations, etc., with the final version also using 
laser-cut and 3D-printed parts for people 

to construct. 

“Rudolph, the burning wood-stove, the house, 
and the star are all laser-cut and glued together,” 
Bas tells us. “There is a cut-out mounting hole 
to keep the micro servo in place. The front 
leg of Rudolph is glued to the servo stick. The 
potentiometer is mounted at the top of the 
chimney of the house. LEDs are mounted in the 
Christmas tree, Rudolph’s nose, and in the house. 
Pico is clicked in a 3D-printed bracket to keep it 
in place, with the USB connector aligned to right. I 
created a full-option sketch where Rudolph’s nose 
is blinking, his front leg is twisting, and all LEDs 
have their own rhythm. By turning the star knob, 
the analogue value changes, which then changes 
several parameters in the [script] to make it even 
more active.” 


Down in history 
The workshop was quite successful, according to 
Bas, with attendees having the planned ‘positive 
programming experience’. 

“They were enthusiastic and eager to get 
started,” Bas mentions. “At first, they were 
very surprised to have an electronic Christmas- 
themed Rudolph which they could connect to their 
own laptop. After a starting introduction of 30 
minutes, they could get the first Christmas lights 
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> All Rudolphs were 
tested before 
the workshop 


> Bas realised how 
much Pico could 
do when getting 
familiar with 
MicroPython.. 


> .and immediately 
got an idea for 
Rudolph when 
asked about it 


fm After a starting 
introduction of 30 minutes, 
they could get the first 
Christmas lights blinking 
and the front leg moving @ 


> Bas likes the idea 
of citizen science 
being done on 

Pico, with people 
sharing data 


blinking and the front leg moving. Once they 
were able to understand how to program a scenes 
themselves and get interaction with the rotating 
star, I saw various applications which I hadn’t 
foreseen myself.” 

Bas is currently planning other holiday- 
themed workshops like this - such as an Easter 
bunny - and is going to bring back Rudolph next 
Christmas: “Having fun with programming with 
a low-entry approach is applicable throughout 
the whole year, and shouldn’t be limited to the 


Christmas season only. an 1 A Within 30 minutes, everyone was impressed with what they could achieve 
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Raspberry Pi Backpack 


Rather than rummage around his bag to set up Raspberry Pi, Nicholas Hacault 
has ensured his computer is always to hand, as David Crookes explains 


Nicholas 
Hacault 


Nicholas Hacault is a 
Cyber Security student 
who loves tech 

and inventing. 


nicholashacault.com 


owning a small, yet powerful, computer 

such as Raspberry Pi. So long as you have 
a screen and keyboard to hand, you can pop one 
into your bag and take it on your travels. Or, as 
Nicholas Hacault has shown, you can actually 
make Raspberry Pi a feature of your bag and gain 
instant access to it wherever you go. 

Nicholas came up with the idea when he was 
looking for a way of transporting a Linux device. 
At first, he considered running a virtual machine 
on his laptop. “But that sounded like too easy a 
solution,” he says. “Since I was already bringing a 
bag to school, I figured that a backpack would be 
the perfect housing for my project.” With the idea 
in the bag, he was ready to get going. 


p ortability is one of the great benefits of 


Pocket plan 
One of his first decisions was the choice of 
backpack itself. “There were a lot of factors I had 
to consider,” he says. “It needed to have space for 
my laptop, chargers, and books, as well as enough 
room to fit Raspberry Pi and all the components 
that come along with it. I decided that a bag 
with lots of different pockets would work best 
because it would make separating the project’s 
components easier.” 

Eventually, he came across a backpack with 
two front pockets: a smaller one for Raspberry Pi 
and battery, and a larger one for the screen. The 
next step was working out how to incorporate 
the tech needed to get his backpack computer up 
and running. “I decided the minimum the project 
needed was a portable power bank, a seven-inch 
touchscreen display, a Bluetooth keyboard and 
mouse, and a Raspberry Pi Model B with 8GB of 
memory housed in a case,” he says. 

The display is powered through a USB cable so it 
can draw its juice directly from Raspberry Pi. The 
computer, in turn, is connected to a 30,000 mAh 
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portable power bank. “It has a USB Type-C input/ 
output rated at 20 watts, and it connects to the 
outside of the bag for easy charging,” Nicholas 
says. “It also has two USB Type-A outputs rated 
for up to 22.5 watts, which is enough to power 
Raspberry Pi, and there are four 20mm fans - two 
to pull air in and two to vent it back out.” 


Packing away troubles 
To house the components, Nicholas designed 
and 3D-printed a range of pieces. “I made a hole 
punch pattern around the edges of the prints 
in order to sew them on to the bag easily,” he 
says. “The biggest challenge was working in a 
confined space and I went through many failed 
3D-printed housings that always seemed to be 
slightly too big.” 

Thankfully, the programming side of the project 
was more straightforward. “There was super- 


lM There was super-minimal 
coding to get it running @ 


minimal coding to get it running,” he says. “All 
I had to do was follow the documentation to 
configure the touchscreen. The screen itself is 
actually installed upside down so the ports face 
the right direction. I needed to change the screen 
orientation in the Raspberry Pi config.” 

Nicholas says there is still room for 
improvement. “The screen is always visible which 
is not great for waterproofing,” he says. He also 
wants to be able to connect Raspberry Pi to a cell 
network or mobile hotspot so that it doesn’t have 
to rely on Wi-Fi. Even so, it’s proven very useful. 
“T can also use it to store items like a normal bag 
as well,” he laughs. 
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Raspberry Pi is 
housed in the 
bottom of the bag 


It also contains a 
power bank 


The screen is 
permanently 
mounted 


Awireless 
keyboard is used 
for input 


An 1/0 panel 
will give better 
port access 


The screen is always on show, 
and Nicholas is considering 
adding a walking animation 
connected to an accelerometer 


Four 20mm fans are 

sewn into the pockets, 

and they're connected in 
parallel using the ground 
and 5V pins on Raspberry Pi 


The bag holds all of the 
components, including 
Raspberry Pi, which is 
housed in a metal case 
to help dissipate heat 
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Alternative 
Flight Simulator 


One inventive aviation fan has cloned the ultimate cabin 
experience. Nicola King searches for her boarding pass 


Alex 
Shakespeare 


Alex works in 

IT consultation, 
while using his 
free time to build 
unique gadgets for 
his home. 


magpi.cc/alexair 


to fly anywhere and just has to have 

the window seat. Therefore, clearly, the 
only reasonable thing to do was to build his 
very own passenger jet plane experience, named 
‘Alex Air’, but on terra firma. As a collector of 
aeronautical odds and ends, all he needed were 
some authentic plane seats (purchased from eBay), 
a plane window, and a few other flying-related 
gizmos. With the help of a Raspberry Pi Zero, Alex 
set about creating a truly unique and distinctive 
addition to his home. 


A lex Shakespeare relishes the opportunity 


First class upgrade 

Apart from the seats, and various aesthetic aircraft 
appendages, there are two key sections to the 
Alternative Flight Simulator that help provide 

an authentic passenger experience. Firstly, Alex 
has constructed a ‘flight selector panel’ that the 
passenger uses to select the airport where they 
wish to land (and there is a wide choice). 

Once a location is selected, a standard PC 
monitor behind the window plays the landing 
video, while two speakers emit some pertinent 
audio, so the passenger can fully immerse 
themselves in their approach into Innsbruck, or 
maybe New York. Alex managed to find all of 
the film/sounds for each specific flight approach 
on YouTube, then scaled and rotated them to fit 
the screen correctly. An overhead fluorescent 
light strip also kicks into action to give a 
realistic experience. 

All of the above is controlled by a Raspberry 
Pi Zero: “I needed something that supports 12C/ 
general IO, was capable of playing video and audio 
and, most importantly, was cheap,” says Alex. 
Raspberry Pi Zero takes inputs from the selector 
panel and outputs to its small LCD display using 
12C. “It’s also responsible for video/audio playback, 
using the HDMI port and a USB sound card.” 
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The second key section, independent of the 
selector panel, is the overhead ‘customer service 
board’ control panel, reclaimed from an old plane. 
This unit is powered by an ESP32 microcontroller, 
and the passenger can use it to switch on the 
light above, be cooled by the three-speed fan, or 
press the assistance button. Cleverly, Alex has 
arranged for his Google speakers to utter those 
immortal words “assistance required” whenever 


Muse it as gd meeting room 
when taking video calls 
for work @ 


the passenger presses this button. Aside from an 
in-flight meal tray containing some unappetising 
foodstuffs, there really is very little missing from 
the Alex Air customer flight encounter, as he has 
even included a whimsical button which plays a 
Ryanair jingle (played in the firm’s aircraft when 
they land on time). 


Brilliant backdrop 

Housed in his conservatory, it looks like the 
Alternative Flight Simulator is there for the long 
haul, so to speak: “It’s pretty much screwed into 
the wall so it’s not going anywhere else. I use it 
as a meeting room when taking video calls for 
work... it beats just having a boring IKEA sofa in 
the conservatory.” Furthermore, Alex Air has been 
very well-received, even featuring in a British 
national newspaper, a radio interview, and in blogs 
far and wide. 

Alex admits that: “People think I’m a bit nuts 
but, having seen my other projects, generally 
expect this kind of thing from me.” Indeed, Alex’s 
other ingenious makes include an automated 
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Choose a destination 
on the exterior selector 
panel before boarding 


cocktail maker, an owl barometer, and an 
automatic pneumatic door. 

While he doesn’t plan on making any changes 
to his Flight Simulator, saying, “I think I’m done 
for now - it does the job,” Alex does intend to 


Raspberry Pi Zero 
plays the landing video 
ona standard monitor 
behind a window 


The authentic airline seats 
were bought on eBay 


> The seats cost Alex 
around £150 


The window and 
other parts cost 
approximately £170 


He already had a 
spare monitor and 
Raspberry Pi Zero 
on hand 


Over three months, 
Alex spent around 
40 hours on 

his project 


See Alex's 
informative 
simulator video: 
magpi.cc/ 
alexairvideo 


post some source code soon, once he’s had the 
opportunity to tidy it up a little. Keep an eye on 
his GitHub page (github.com/shakso) if you are 
interested in replicating this high-flying and 
deliciously eccentric venture. Hl 
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Geiger Counter 


Concerned about the potential of rising radiation levels in Ukraine, 
Dmytro Panin has set about monitoring them, as David Crookes explains 


Dmytro Panin 


Dmytro Panin is a 
programmer based 
in Kyiv, Ukraine, and 
he wrote his first 

line of code aged 
eight. He works for 

a large provider of 
nearshore software 
engineering services. 


magpi.cc/ 
onlinegeigercounter 


in August 2021 when we looked at his Air 

Quality Traffic Light - a project designed 
to monitor the pollution in the atmosphere of his 
home city of Kyiv in Ukraine. Never did we ever 
imagine, little more than a year later, he would be 
seeking to detect dangerous levels of radiation in 
the air, but that’s where he finds himself today. 

“The vast majority of the projects I build are 

created out of necessity,” he tells us. “This one, 
unfortunately, is no exception. With almost daily 
threats of a nuclear catastrophe at one of our 
power plants due to Russian shelling or hints of 
a nuclear strike, some of us started to wonder 
how to detect an increasing level of radiation if 
something were to happen.” 
This prompted him to create a device using a 
Raspberry Pi Pico W. “Radiation is not something 
you can feel, see, taste, hear, or smell,” he says. 
“So, I created a device designed to be a silent 
observer of the ionising radiation levels in my city. 
I wanted it to become the sixth missing sense, if 
you will.” 


0 ur initial contact with Dmytro Panin came 


Keeping count 

As well as Raspberry Pi Pico W, the build includes 
an M4011 Geiger—Miiller tube. It’s old technology, 
for sure - the concept was developed back in 1908 
at the University of Manchester and it came into 
being 20 years later. “But I’ve never had an excuse 
to work with it, so I took it as a way to improve 
my knowledge,” Dmytro says. “It may be old, but 
it’s very important tech.” 

At first, he tried to find all the components 
required to build a rudimentary Geiger counter 
from scratch before realising it would take him too 
long to locate everything he needed. “I then came 
across a pre-built module based on the M4011 
which has a digital pin that can relay the tube’s 
pulse caused by an ionising event,” he continues. 

“T configured an interrupt on one of the pins 
of my Raspberry Pi Pico W so it can listen and 
‘remember’ the number of ‘ticks’ that the Geiger 
tube experiences over a period of time. Based on 
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that, I can interpolate (or sometimes extrapolate) 
the current CPM (counts per minute).” 


Stark warning 
Understanding that CPM - while generally 
accepted and widely used in measuring radiation 
- doesn’t universally equate to dose rate, he 
implemented a conversion to sieverts per hour, a 
unit that allows radiation levels to be expressed. 
“Fortunately for me, DFRobot, the creator of 
the module, had an easy conversion formula for 
M4011,” Dmytro says. “So I decided to use that.” 
Dmytro has placed the device next to a window 
in his apartment and it’s connected to an OLED 


M Due to the power 
blackouts we're having, 
the readings are not 
updated very often @ 


screen so that he can keep an eye on the current 
radiation level. It’s also possible to check the 
device from afar. 

“Raspberry Pi Pico W can push the readings 
to a server every few hours so I can keep track 
of what’s happening with the ionising radiation 
levels even if I’m not home,” he explains. “But, 
unfortunately, due to the power blackouts we’re 
having, the readings are not updated very often as 
I don’t keep the device plugged in any more.” 

So far, the device has been showing around 
25 CPM. “That’s what you expect from a tube like 
this in a ‘normal’ environment,” Dmytro says. 
“As for what reading would indicate a problem, 
well, I hope we won’t need to learn this,” he 
says. “But, overall if the readings are drastically 
higher than what they are at the moment, I’d 
interpret it as a problem that requires more 
thorough investigation.” Fingers crossed it never 
comes to that. Hl 
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BioBusiness 


Stable supply and a “golden” relationship with technical 
staff supported the medical equipment company to scale 


gyptian medical equipment manufacturer 
E BioBusiness needed to integrate IoT 

capability into its successful line of patient 
monitoring devices. Raspberry Pi technology 
allowed them to do it. BioBusiness was founded 
in 2009 by Mostafa Elwakeel and two medical 
and software engineer colleagues, with a focus 
on equipment, manufacturing, and design, as 
well as IoT related to medical devices. The three 
entrepreneurs, all recent graduates, set up a 
medical equipment business with a primary R&D 
centre in Cairo, Egypt and a production factory in 
Serdang, Malaysia. 

The trio recognised the potential for Internet 
of Things-based monitoring products in medical 
settings, and set about creating a patient- 
monitoring ECG machine, ventilators, and other 
critical equipment. Demand for such devices was 
immediate: as well as manufacturing for sale under 
its own brand in Egypt, BioBusiness soon found 
itself making ventilators and other equipment, such 


as CPAP monitors, on behalf of some of the biggest 
names in pharmaceutical and medical equipment, 
including Philips, Siemens, and GE. 


THE CHALLENGE 
BioBusiness soon began manufacturing ventilators, 
as well as IoT devices that captured and shared 
medical imaging data, including ultrasounds, 
radiation, X-rays, and MRIs. For its next 
product line, BioBusiness wanted to develop IoT 
monitoring devices on an OEM (Original Equipment 
Manufacturer) basis, for sale to the likes of 
Siemens, GE, and Philips. The devices needed 
to provide detailed environmental information 
including temperature, humidity, and air quality 
readings, as well as measuring and analysing 
three-phase power. 

However, the need to connect everything to 
the cloud complicated things. The field engineer 
support team needed to be able to remotely 
monitor MRI and CT machines which, in a 


hospital environment, may need to be mobile. 

More pressingly, BioBusiness needed to secure 
components for its growing Medicare portfolio 

in sufficient quantities that it could scale up 
manufacturing as its client base increased and, with 
it, demand for its products. 


THE SOLUTION 

BioBusiness chose Raspberry Pi Compute Module 4 
and RP2040 microcontrollers when it became 
challenging to meet growing demand with its 
usual microcontroller supply and semiconductor 
RAM. Its CPAP (continuous positive airway 


fm The company is almost 
Unique in Egypt in 
terms of its medical 
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pressure) device uses RP2040 to measure 

oxygen levels over time. “It’s the main portable 
device monitor that controls the power inputs 

and pressure sensors, and runs a display with 

LCD data needed by a patient,” says Mostafa 
Elwakeel. It also sells a Raspberry Pi-based oxygen 
concentrator that makes efficient use of the 
oxygen in ambient air and lets the user adjust the 
flow, plus a power quality monitor. 


WHY RASPBERRY PI? 

BioBusiness chose Raspberry Pi for these life- 
critical monitoring machines after a thorough 
review of the technical specification of both 
Compute Module 4 and RP2040. An initial order 
of 14,000 RP2040s duly arrived, providing a 
sizable inventory to draw on as demand stepped 
up. Although the size of the order represented a 
significant outlay for the 49-employee company, 
their existing client list of approximately 500 
customers in Egypt, as well as their multinational 
Medicare clients, and their confidence in 
Raspberry Pi’s reliability and support, meant it 
was a calculated risk. “We appreciate the good 
availability of the RP2040,” confirms Elwakeel. 
Having an established relationship with Raspberry 
Pi helped ensure continuity of supply of CM4 when 
silicon shortages hit global supply chains. 

Ease of integration with existing products, and 
the flexibility to use a choice of components in a 
range of existing and planned Medicare products, 
mean that Raspberry Pi and Linux have proven a 
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good choice for BioBusiness, while the relationship 
built up with technical staff at Raspberry Pi has 
been in marked contrast to Elwakeel’s experience 
with other computing component suppliers. 

He describes the relationship with Raspberry Pi 
as “golden”. Steady reliability, with any issues 
encountered due to Linux rather than hardware, 
means BioBusiness is keen to continue using 
CM4 and RP2040 in its products, as it seeks to 
expand its portfolio as well as its geographical 
customer base. 


THE RESULTS 

BioBusiness has gone from strength to 

strength, and now uses Raspberry Pi’s RP2040 
microcontroller and Compute Module 4 in its 
oxygen concentrator, CPAP machine, and power 
quality monitor products. The company is almost 
unique in Egypt in terms of its medical equipment 
offerings, something Elwakeel would like to see 
change. “Unfortunately, ours is the only company 
in Egypt that produces this kind of R&D. It’s good 
for us, but not good for the country.” 

Most of BioBusiness’s client list has been 
built up through a combination of meetings 
and representation at industry events 
such as MEDICA, and awareness- 
raising in the medical trade press. 
Government support during the 
Covid-19 pandemic was important 
too: the Egyptian government 
encouraged BioBusiness to expand 
to help meet a critical need for é 
medical equipment to diagnose 
cases and care for patients. 

BioBusiness already has a strong 
business presence in Southeast 
Asian countries such as Indonesia, 
Malaysia, Singapore, Thailand, and 
Micronesia. For the future, Elwakeel 
sees further expansion in Asia and 
the Middle East. He envisages new 
products based around Raspberry 
Pi, with a focus on integrating RTLS 
(real-time location systems). 


“Ty 
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Unleash the 
full power of 
Raspberry Pi and 
Pico with these 
handy hints. 

By Phil King 
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itha 
Raspberry 
Pi 4or 


400, you can connect 
two monitors. 


With the power 
off, connect two 
micro-HDMI to HDMI 
cables to the micro-HDMI 
ports on Raspberry Pi. Note 
that on Raspberry Pi 4, the 
primary display port is marked 
‘HDMIo’, next to the power input; 
on Raspberry Pi 400, it’s the one 
next to the microSD card slot. 
Connect each of the full-size HDMI 
ends of the cables to an HDMI input on 
one of your monitors/TVs. Turn on the 
displays and then the Raspberry Pi. When it 
boots up, a desktop should appear on 
each monitor. 
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02 The primary 
display, with a 
taskbar at the top, should 
be on the left-hand 
monitor. If not, go to 
Preferences > Screen 
Configuration to opena 
dialog showing the layout 
of the monitors. To switch 
them around, drag the 
left-hand one to the 
bottom, then the right- 
hand one to the left, and 
the bottom one back up to 
the right. Click the green tick icon to confirm and you'll 
be asked to reboot; click Yes. 


With the monitors in the correct orientation 
once rebooted, you should now be able to 
move the mouse pointer between them, as if they were 
one long, continuous desktop. You can also drag 
windows between them to make full use of that 
increased screen real estate. 
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You can change the system 

font and its size for Raspberry Type: Os 
Pi OS. Right-click 

the desktop and select Desktop 
Preferences. In the Appearance 
Settings dialog, select the System tab 
and choose the desired font and point 
size. You can also alter the mouse 
cursor size. Select OK when done (or 
Cancel). Note that this won't change 
Select the text size in applications such as 
Chromium and Terminal. 


To take a grab of the whole 


Take a screenshot 

Type: OS 
screen, press the PRTSCN key, 
found to the right of the function 


keys on most keyboards. Alternatively, use the scrot 
command in a Terminal window; it can be used with 
the -d switch to add a delay in seconds, e.g: 


scrot -d 10 


You can also add the -s switch 
and then select a window or drag 
an area of the screen to grab. By 
default, grabs are saved as PNG 
files with a timestamped name 

in the home directory, but you 
can add a path and file name to 
the command. See magpi.cc/ 
screenshot for more details. 


Software search 


To search for software packages in the APT 
(Advanced Package Tool) repository from 
the command line, enter apt-cache search 
followed by the search term. 
Alternatively, download the 
Sources.gz file from magpi.cc/ 
aptsourcesbullseye and use 
gunzip to extract it for the full 
list of software packages. Install 
one with sudo apt 
install followed by 
the name. 
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Defaults 


Set Defaults 


For large screens 


Set Defaults 


Set Defaults 


For medium screens 


For small screens 


Cancel OK 


After connecting Raspberry Pi toa 


Desktop icon size 
larger, higher-res TV or monitor (or Type: OS 
a smaller one), you may find that 


the desktop icons in Raspberry Pi OS are too small (or 
large). To fix this, right-click the desktop and select 
Desktop Preferences. In the Appearance Settings 
dialog window, select the Defaults tab and then click 
‘Set Defaults’ for a large, medium, or small screen. 
Then click OK to confirm, or Cancel the changes. 


By default, 


GPU memor 
Raspberry Pi Type: Hardware/OS 
OS reserves a 


certain amount of RAM for the GPU (graphics 
processing unit): on models with 1GB or 

less of RAM, it's 64MB; on others, it's 76MB. 
You can alter this by going to Preferences 

> Raspberry Pi Configuration, selecting the 
Performance tab, and entering a new value in 
the GPU Memory 
field. You may 
need more for 
graphics-intensive 
applications, 

or less for 

other uses. 


Avery handy feature at 

the command line is the 
ability to cycle through 
previous commands you've 
entered, simply by pressing 
the up arrow key repeatedly, 
so you can re-enter them 
quickly. You can press the 
down arrow to move back 
down through them. 


Type: Terminal 


FEATURE | Might 


Want to print something out 


Menu shortcut from your Raspberry Pi? You'll 


Type: Hardware/OS 
need CUPS, which should be 
A quicker way to bring up the Tvpe: OS pre-installed on the latest 
applications menu, without clicking YEE: version of Raspberry Pi OS - if it's not, you can install it from a Terminal (see 


the raspberry icon at the top left, magpi.cc/printing). Point your Chromium browser at localhost:631, bypass 
is to press the Raspberry Pi logo key on an official the security warning, and you'll see the CUPS interface. From here, under 
keyboard, or CTRL*ESC. Then use the arrow keys to Administration, after logging in with your username and password, you can 
navigate its options, and ENTER to select. add a network printer. You can then select it when printing with CTRL+P. 


3 reconfigure a custom Raspberry Pi OS setup mare a Type: Hardware/OS 


with the Imager tool. 


01) Download Raspberry Pi Imager (from 
magpi.cc/imager) for your computer and 


launch it. Connect a microSD card to the computer 
using a USB card reader. Click on Choose OS and 


select a variant of Raspberry Pi OS. Then click the gear 
icon that's now appeared at the bottom right to open 
the advanced options. 


03) You can connect Raspberry Pi automatically to 
your Wi-Fi network when it boots up. Enter the 
SSID (name) of your router and its password. Select 
your Wi-Fi country, then your Locale, timezone, and 
keyboard. Click Save, then write the OS to the microSD 
card as normal. 


02 At the top, you can set a custom hostname for 
Raspberry Pi - useful for finding it more easily 
on the Wi-Fi network and connecting via SSH, which 
you can enable here. Next, you can select a username 
and password. 
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Raspi-config 


While you can alter common system settings in 
Preferences > Raspberry Pi Configuration 

on the desktop, there is an alternative 

method accessible from the command 


M you can alter 
common 
system settings 
in Preferences 


line. In a Terminal window or SSH 
connection, enter the command sudo raspi-config 
to open this configuration tool. Use the arrow keys and 
ENTER to navigate the menus. After changing settings, 
select Finish to save them - you may be asked to 
reboot. See magpi.cc/raspiconfig for all the details. 
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Check storage left 


When on the 
desktop, you can 
easily see the free 
system storage 
remaining at the 
bottom of the File 
Manager window. 
Alternatively, if 
working headless, 
you can enter the 
Terminal command df -h, 


Add and switch users 


You're not limited to one 

user on Raspberry Pi. “Type: Terminal | 
You can add more users 

and switch between them. To add a user, enter the 
command sudo adduser followed by the desired 
username. You'll be asked to enter the current user's 
password, then a new one for the new user. You 

can then enter optional user details or leave them 
blank by pressing 
ENTER repeatedly. 
To switch to 
another user, 
enter su followed 
by the username 
and enter 

their password. 


et Pico W to connect to your 
wireless network. 


01) Unlike a standard Pico board, Pico W comes 
with Wi-Fi. To connect it to your wireless 
network, you'll need to write a short program. After 
flashing Pico W with the MicroPython firmware (from 
magpi.cc/micropython), connect it to a computer via 
USB, open the Thonny IDE, and select the 
‘MicroPython (Raspberry Pi Pico)’ interpreter at the 
bottom right. 


At the top of our program, we import the 
network and time modules: 


We then set up the wireless connection. Replace 
‘SSID’ and ‘Password’ here with your own wireless 
network's details: 


FEATURE | Might 


We then run a loop to display a message until the 
connection has been made. Once it has, Pico W's IP 
address will be shown (the first of the four displayed). 


03) Save and run the 
program to ensure 
a successful connection 
is made. You may well 
want Pico W to connect 
automatically to your 
wireless network 
whenever it boots up. If 
you save your Wi-Fi 
connection program as 
boot.py, it'll automatically run upon Pico W bootup. 
You could also embellish the program by handling 
connection errors and/or even making Pico W's on- 
board LED flash during connection. To disconnect from 
a network, run the command: wlan.disconnect(). 
Note that wireless connection when using the 

Pico C SDK involves a different process - see 
magpi.cc/internetpicow for details. 
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Find out which 
software packages 
are installed on 
your Raspberry Pi 


To find out which 


See installed packages 
software packages are “Type: Terminal | 
already 


installed on Raspberry Pi, enter the 
command sudo dpkg -1. You'll be 
presented with a list of packages; 
use the arrow keys to scroll up and 
down, and Q to exit. 


To list the processes 


See what's running 
running on your 


Raspberry Pi, enter the 


htop command to list them in descending order 
of CPU usage. This is a good way to discover a 
rogue process that’s slowing down your machine. 
You can search and 
filter the processes 
by name or user and 
kill a rogue process 
that is using too 
much memory - or 
use the sudo kill 
command with 

its PID. 
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Tab auto-complete 


When entering 
commands ina 
Terminal window 
or via SSH, this 
feature can help 
speed things up. 
Start typing a 
commana, file, or 
directory name 
and then press 
TAB to either 
auto-complete it fully or partially - in the latter case, 
press TAB again to see the possibilities, then type 
some more characters. 


Auto-run programs 


If you've created . 

a project that you Type: OS/Terminal 
want running all 

the time, you'll want to ensure that its program starts 
up automatically whenever Raspberry Pi is booted 

up. There are several ways of doing this, but one of 
the simplest is to create a cron job to run it. Froma 
Terminal, enter crontab -e. If this is the first time 
you've used crontab, you'll need to select a text editor, 
such as Nano, from the options. At the bottom of the 
file, you can add a line to run one or more programs 

at set times or upon reboot. For the latter, enter 
@reboot followed by the command to run the code, 
including the full path to the file, e.g. @reboot python3 
/home/pi/weather.py & That & ensures it'll run in the 
background. Press CTRL#X, then Y to save it. For more 
details, see the crontab manual: magpi.cc/crontab. 


Alternative 0S 


While Raspberry Pi OS is a 
great operating system, there 
are numerous alternatives 


you might want to try, some of them designed 
for specialist purposes such as 3D printing, 
digital signage, and CCTV. Check out our 
feature on Raspberry Pi operating systems in 
issue 111: magpi.cc/111. 
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Secure Shell (SSH) is a 


SSH remote access 
useful way to access 


Type: Remote 
and control your 


Raspberry Pi from another computer or device. 
You'll first need to enable it in Raspberry Pi OS: 
go to Preferences > Raspberry Pi Configuration, 
select the Interfaces tab, and turn on the switch 
next to SSH. Alternatively, you can enable it in the 
raspi-config tool from the command line. 

Once enabled, you can SSH into Raspberry 
Pi from another computer. On Linux, macOS, 
or Windows 10, open a Terminal and enter 
ssh <user>@<IP> - for example, ssh 
pi@192.168.1.121. Enter the password to connect. 
You can now enter commands on your Raspberry 
Pi, just as if you were ina 
Terminal on it. 

Alternatively, you can 
use the PuTTY application 
(putty.org) for Windows to 
connect. There are also SSH 
apps available for Android 
and iOS devices. 


With SSH enabled, you 


SCP secure copy 
can transfer files securely Type: Remote 
from Raspberry Pi to 


another computer (and vice versa) using SCP (secure 
copy protocol). To do so, from a Terminal on the other 
computer, use the command: scp <user@IP>:path/ 
to/file path/to/ destination. For example, enter scp 
pi@192.168.1.121:/home/pi/test.py /home/magpi/ 
program. py, to copy the test.py file on Raspberry Pi 
to program.py in the magpi directory on your local 
computer. You'll be prompted for the password. Note: 
you can omit the second file name to use the same 
name and/or replace the 
destination path with a dot (.) 
to use the current directory. 
To copy a local file to the 
remote Raspberry Pi, use 
the format: scp path/to/ 
file <user@IP>:path/to/ 
destination. For example, 
scp /home/magpi/program. py 
pi@192.168.1.121:/home/pi/ 
test2.py. 
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VNC remote access 


Another way to access 
Raspberry Pi remotely is to 

use VNC (Virtual Network 
Computing). This gives you full access to its GUI 
desktop. To enable VNC on Raspberry Pi, go to 
Preferences > Raspberry Pi Configuration, select the 
Interfaces tab, and turn on the switch next to VNC to 
enable it, then click OK. Alternatively, you can enable 
it in raspi-config from the command line. You'll see the 
VNC icon in the taskbar. 

On another computer, download the VNC Viewer 
application from magpi.cc/vneviewer and launch it. 
Open a new connection and enter the IP address for 
your Raspberry Pi in the first field, give the connection 
an optional name, then click OK. Double-click the new 
connection, then enter the username and password 
to connect. You can now see and use Raspberry Pi’s 
desktop as if you were running it locally. 


Headless resolution 


You can set the desktop 
resolution for your 

remote VNC connection 
independently to that of a monitor to which 
Raspberry Pi is connected. Go to Preferences > 
Raspberry Pi Configuration, select the Display tab, 
and click on the value for Headless Resolution to 
select the desired resolution, e.g. 1920x1080. 
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Rather than setting up 


Headless setup 
Wi-Fi and enabling SSH Type: Remote 
from within Raspberry Pi 


OS, you may want to preconfigure it as a headless 
setup so you don't need to connect it to a monitor 
in the first instance. You can do so when writing 
the OS to a microSD card with Raspberry Pi 
Imager. Click on Choose OS and select a version of 
Raspberry Pi OS. Now click the gear icon to open 
the advanced options. Here, you can enable SSH 
and set the username and password, as well as 
adding connection details for your Wi-Fi router. 
You may also want to set a custom hostname, to 
use that to connect 
via SSH instead of 
the IP address. Once 
done, click Save, then 
flash your microSD 
card as usual. 

See ‘Custom OS 
setup’ (page 37) for 
details of the other 
advanced options. 


Amore secure alternative 


SSH public ke 
to using a password Type: Remote 
for your SSH remote 


connection is to employ a public key. In Raspberry 
Pi Imager’s advanced options, enable SSH and then 
select the ‘allow public key authentication only’ 
option. In a Terminal on your local computer, you'll 
need to generate the public and private keys: enter 
the command ssh-keygen. You have the option of 
renaming the files, or just pressing ENTER to skip, 
and adding an optional passphrase for extra security. 
Once generated, copy the contents of the public key 
(id_rsa.pub by default) into the ‘set authorized_keys’ 
field in Imager. Then click Save and flash the OS to the 
microSD card as usual. 

Now, when you SSH in 
from that computer, with 
the usual ssh <user>@<IP 
or hostname> command, 
it'll connect, showing the 
SHA fingerprint; type ‘yes’ 
to confirm. If you set a 
passphrase, you'll also 


have to enter that. 


Wireless hotspot 


When you're 
Type: Remote/Camera | using your 


Raspberry Pi out 
and about - maybe with a Camera Module - without 
access to a Wi-Fi network, you may well want to 
access it from another device, such as a phone. For 
this, you can set Raspberry Pi up as a wireless access 
point (aka hotspot). For more details, see magpi.cc/ 
rpihotspot, skipping the ‘Enable Routing and IP 
Masquerading’ section. Once connected to the 
hotspot, you should be able to SSH in to Raspberry Pi. 


M A more secure 
alternative to using a 
password for your SSH 
remote connection is to 
employ a public key @ 


USB boot 


The default option 
for booting a 
Raspberry Pi is 


Type: Hardware/OS 


from a microSD card, but it’s possible to boot it 
from a USB mass storage device - such as a flash 
drive, hard disk, or SSD - instead. There are different 
methods for setting up USB boot mode depending 
on which Raspberry Pi model you're using. See 
magpi.cc/bootusb for details. 
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Portable power 


If you want to use 
your Raspberry Pi 
away from a mains 

power point, you'll need some form of portable 
power. The simplest method is to use a standard 
mobile phone charger or power bank: just connect 
it via a USB cable to Raspberry Pi's power port. 
Alternatively, for a smaller footprint, it’s possible 

to use a LiPo battery pack with the addition of 

a special HAT or SHIM. Some can be combined 

with mains power as a battery backup for an 
uninterruptible power supply (UPS) and they may 
also offer power management options. 


Warning! 
Battery Safety 


Be careful when working 
with lithium ion batteries. 
They are highly flammable. 

Be sure to keep battery 

projects in a case. 


magpi.cc/lithion 


It's also possible to 


Network boot 
boot a Raspberry Type: Hardware/OS 
Pi computer via a 


network connection, which is useful for overcoming 
any issues with microSD card corruption. Note that it’s 
best to use an Ethernet connection rather than Wi-Fi, 
for higher speeds. 

There are currently two ways of doing this. The 
first involves setting up a DHCP/TFTP server - see 
magpi.cc/networkboot for full instructions. The 
second, Network 
Install, enables you 
to download and 
run the Raspberry Pi 
Imager tool from a 
network connection, 
so you can install 
an OS directly on 
Raspberry Pi without 
needing a second 
computer - see 
magpi.cc/installnet 
for details. 
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Overclocking 


Each Raspberry Type: Hardware/OS 
Pi model is 


configured to run 

at a set maximum CPU clock speed by default. For 
instance, later Raspberry Pi 4 models will run at 
1.8GHz. However, it is possible to boost this speed 
by ‘overclocking’ the chip. This involves editing the 
config.txt file in the boot directory - see the ‘Edit 
config.txt’ tip (page 52) - and adding lines to set 
the CPU frequency in MHz (e.g. arm_freq=200@), 
along with over_voltage and gpu_freq. See 
magpi.cc/overclock for details. 

Note that overclocking may cause system 
instability and reduce the CPU's life span. In 
addition, to keep the temperature down, you may 
need to use a cooling solution such as a heatsink, 
stand, or fan. 


Picamera 2 


Instead of issuing individual 

commands in a Terminal, you 
can write Python programs 

to control your Raspberry Pi Camera Module or HQ 
Camera. A new Picameraz library is currently in beta 
and usable with the new libcamera-apps. It is now pre- 
installed in the latest version of Raspberry Pi OS. Go to 
magpi.cc/picamera2doc to read the manual. 


Blinking LED 


Full-size Raspberry 

Pi computers have a 
red power LED and 

a green ‘ACT’ LED near the power input. The 
latter blinks erratically during bootup to indicate 
everything's working. It also blinks special 


patterns to indicate errors - see magpi.cc/ 
actled for the full list. 


M Each Raspberry Pi 
model is configured 
to run at a set 
maximum CPU clock 
speed by default @ 
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Check camera connection 


7 There's an easy way to 
Ra S be ir Pi 40 0 G P | 0 double-check that your Type: Camera 


Camera Module or HQ 


Raspberry Pi 400 Camera is connected 
has the same 40- Type: Electronics correctly and has been 


pin GPIO header detected by Raspberry 

as other Raspberry Pi computers. Using a standard Pi. In a Terminal, enter 

HAT with it isn't ideal, however, due to the header the command vcgencmd 
being at the rear of the keyboard unit, which get_camera. The result 
means that a display or LED matrix HAT faces should include ‘detected=1" If 
backwards. This can be overcome with a GPIO not, check your camera cable 
adapter (such as magpi.cc/pi40oadapter) or a is connected correctly at both 
ribbon cable (magpi.cc/pi4ooribbon). Make sure ends (Camera Module and 
you connect it the right way up - physical pin 1 Raspberry Pi). If using an older 
(3V3) is at the top right and pin 40 (GPIO21) at the version of Raspberry Pi OS, the 
bottom left. as indicated on the case. camera may not have been 


enabled - check in Raspberry Pi 
Configuration or raspi-config. 


eoocoe 2008000 000 
@00 8 @000 00 000 


Raspberry Pi pin numbers (48, 384, 38, 28, Zero, At, B+) | U S I n d n A D C 


oo Ou On Ov ose Unlike Pico (see ; 
‘Read Pico's Type: Electronics 


analogue inputs’ 
tip, overleaf), Raspberry Pi computer models only 


VN C camera p review allow digital inputs via the GPIO header. If you 


By cersuiayou need to connect a component with an analogue 
SORE DEBE Type: Remote/Camera output signal, such as a potentiometer or certain 
Po viourine sensors, you will need to do so via an ADC 
(analogue-to-digital converter) chip such as the 
MCP3008. Careful wiring is required, including 
connecting four of the ADC's pins to the SPI pins 


on Raspberry Pi. See our Plant Monitor tutorial in 
issue 114 (magpi.cc/114) for an example. 


camera preview 

window when accessing your Raspberry Pi remotely 
from another computer via VNC. However, there is a 
setting to make the window appear. On Raspberry Pi, 
click the VNC icon in the taskbar, open the menu (top 
right icon), go to Options > Troubleshooting, then tick 
‘Enable direct capture mode’ and click OK. 
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Using PWM 


Pulse-width modulation 
(PWM) is a way of 
modulating a digital 


output signal to adjust the speed of a motor or the 
brightness of an LED. It works by pulsing a GPIO pin 
output on and off at high frequency, e.g. 50Hz. By 
altering the ‘duty cycle’ - the proportion of the time the 
pin is on versus off - you can alter the average level of 
voltage output to the component. 


While servos can 


Drive motors 
be controlled from Type: Electronics 
a GPIO pin using 


PWM, for standard motors you'll need an H-bridge, 
usually in the form of a breakout board or HAT. The 
H-bridge enables you to drive a motor in forward 
or reverse, while PWM is used to determine the 
speed of the motor. A dual H-bridge enables you to 
connect two DC motors - or one stepper motor - 
and control them independently. 
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Type: Electronics | | 


|. Read resistor codes 


The coloured . 
standard through- 

hole resistor tell you its rating in ohms (Q). Ona 
four-band resistor, the first two bands represent 
digits, the third is a multiplier, and the fourth 
shows the tolerance level. For instance, orange- 
orange-brown-gold is 33 x 10 (i.e. 330Q) with a +5% 
tolerance. Five-band resistors have a third digit 
band and the multiplier on the fourth band. For a 
handy calculator, go to magpi.cc/resistorcodes. 


Member of Bands 

pera rere 

Resistor Parameters Outpet 

‘Vet Band of Cotor 

= ‘5 ee 
Merete an ES = 
Tere 

srueurce ce Resistor value: 

ee oe 


360 Ohms 5% 


When programming z 
Raspberry Pi Pico with 
Thonny on a connected 

computer, you can save a MicroPython file directly 

- onto Pico, but what if you want to copy any other 
files or folders to it? In the Files pane (select View > 
Files if not shown), navigate to the file or folder within 
the computer file structure shown at the top. Then 
right-click and select ‘Upload to /’ to copy the file or 
folder onto Pico. 


+ Thonny - Raspberry Mice = pretwork oy @ 12:23 


. 
erent» — | rermart oy | 


iol) and wian.otatwn() v= © 
to connect..." 


int Cuban sewn gt) 


Copy files to Pico 


Reset Pico 


While Pico doesn't have a reset P 
button, it’s possible to quickly 
reboot it by connecting the 

RUN pin (physical pin 30) to GND. This saves you 
having to unplug and reconnect the USB cable 
every time you want to flash a new UF2 file. For 


more convenience, you can even wire those pins to 
a push-button. See magpi.cc/picoreset for details. 


M Pico can accept 
analogue inputs on 
some of its GPIO pins H 


With Pico W's Wi-Fi 


Pico W web server 
connectivity, it’s possible 


Type: Pico 
to use it to generate a 


simple web server to access from another 
device. This can then be used to remotely 
control components attached to Pico W, such 
as an LED. See magpi,cc/picoserver for more 
info on how to set it up. 
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Re-flash locked Pico 


If you mistakenly create an 7 
auto-running main.py 
program that blocks REPL, 

Pico could refuse to communicate with Thonny 
or other IDEs. In this case, there are two options, 
both involving flashing a special version of the 
MicroPython UF2 firmware to Pico. The first, 
downloaded from magpi.cc/picomainrename, 
simply renames the main.py file so it doesn't 
auto-run. If that doesn't solve the issue, the 
alternative is to flash Pico with the ‘flash_nuke’ 
UF2 file from magpi.cc/piconuke, but this will 
erase all the programs on it! 


Read Pico's 


Unlike Raspberry Pi computers, 


analogue inputs 
Pico can accept analogue inputs Type: Pico 
on some of its GPIO pins, as 


they're connected to an on-board ADC. As well as 
accepting digital inputs, GP26, GP27, and GP28 accept 
analogue inputs (up to 3.3V) as ADCo, ADC1, and 
ADC2z2. The GND pin between them (on physical pin 
33) doubles as an AGND. A fourth analogue channel is 
wired to Pico's on-board 
temperature sensor. 

To assign an analogue 
input in MicroPython, you 
use machine. ADC followed 
by the GPIO pin number 
in brackets, e.g. (26). 

To read it, you use the 
.read_u16() suffix instead 
of the normal . read for 
digital pins; this turns it 
into an unsigned 16-bit 
integer between 0 and 
65535. For more details, 
see magpi.cc/ 
picoanalogue. HZ] 
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magpi.cc/ 
hauntedowlbear 


| You'll Need 


» Pico SDK 
magpi.cc/picosdk 


» Pico Extras 
magpi.cc/ 
picoextras 


» Kilograham's 
B-Em fork 
magpi.cc/bem 


> Make sure that the 
Pico SDK, Pico Extras, 
and B-Em source 
code folders are all 
in the same directory 
before you compile 


Emulate a 
BBC Micro on 
Raspberry P1 400 


With an optimised version of the B-Em emulator, Raspberry Pi 400 
can take us back to the heyday of the British micro that inspired it 


Computers’ BBC Micro helped to kick-start 

a revolution in software and hardware 
development. Its influence is imprinted on 
products ranging from the ubiquitous Arm 
processors to modern gaming blockbusters like 
Elite Dangerous. 

But emulating the BBC on modest hardware 
has traditionally been a chore. There are several 
excellent BBC emulators, and you can run most 
of them on Raspberry Pi, but only at the cost of 
major performance issues. 

That’s no longer the case, thanks to Raspberry 
Pi Pico SDK architect Graham ‘kilograham’ 
Sanderson who’s forked an optimised version 
of the B-Em emulator that’ll run smoothly on 
both the Raspberry Pi Pico microcontroller and 
Raspberry Pi SBCs. 


FE rom schools to bedrooms, Acorn 
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Check your graphics settings 
When building this B-Em fork for 
Raspberry Pi, you need to make sure that the 
compositor is disabled and that you’re not using 
the legacy video driver. If you’re running a fresh 
Raspberry Pi OS Bullseye install on Raspberry 
Pi 400, neither of these should be the case, but 
it’s worth checking. 
To do so, open a Terminal window and type: 


sudo raspi-config 


Select ‘6 Advanced’, then ‘A3 Compositor’. Make 
sure this isn’t enabled. If your hardware and OS 
versions support the legacy video driver, you’ll 
also find this in the advanced menu. Similarly, 
make sure it’s disabled. Reboot. 


Gather your dependencies 
At the Terminal type: 


sudo apt install build-essential cmake 
libdrm-dev libx11-xcb-dev libxcb-dri3-dev 
libepoxy-dev ruby libasound2-dev 


Although we’re building B-Em for Raspberry 
Pi, we’ll still need the Pico SDK. The Pico SDK, 
Pico Extras, and B-Em folders all need to be in the 
same directory. We’ll make a directory called Pico 
in our home root to put everything in, then put all 
the software we need in it. 


You should substitute the wget URL in the next 
step with the current release version of the Pico 
SDK (magpi.cc/picosdk). 


Build B-Em 


Enter the following Terminal commands to 
download and make the software: 


cd 

mkdir Pico 

wget https://github.com/raspberrypi/pico- 
sdk/archive/refs/tags/1.4.0.tar.gz 

tar -xzf 1.4.0.tar.gz 

git clone https://github.com/raspberrypi/ 
pico-extras.git 

git clone https://github.com/kilograham/b- 
em. git 

cd b-em 

mkdir pi_build 

cd pi_build 

cmake -DPICO_SDK_PATH=path/to/pico-sdk -DPI_ 
BUILD=1 -DPICO_PLATFORM=host -DDRM_PRIME=1 
-DX_GUI=1 .. 

make -j4 


Following these instructions, the path to Pico SDK 
will be something like: ~/Pico/pico-sdk-1.4.0. 


Is this thing on? 

B-Em emulators for the BBC Micro (xbeeb) 
and Master (xmaster) will be built two directories 
below the pi-build directory we made earlier, in 
src/pico. Assuming you still have the Terminal 
open from the previous step: 


cd src/pico 
./xbeeb 


You should find yourself looking at an emulation 
of a 32K BBC Micro running Acorn’s 1770 DFS (disk 
filing system). 


Would you like to play a game? 

Unlike other BBC emulators, including the 
fully loaded versions of B-Em, there’s no graphical 
interface to browse and load disk image files. 
Fortunately, B-Em for Pico loads a copy of Eben 
Upton’s port of puzzle game 2048 by default. Not 


While a 4:3 CRT would be the most 
flattering choice of display, B-Em 
displays at the correct aspect ratio if 
all you have is a 1080p LCD monitor, 
here displaying shoot-em-up Guntus 
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This build works 
beautifully with our retro 
joystick projects, but 
modern controllers work 
just as well and give you 
more buttons to assign 


all the keys and characters on Raspberry Pi 400 
map tidily to those of a BBC Micro - see Figure 1 
overleaf. In B-Em, type: 


...to list the files on the virtual disk, then: 
*EXEC !BOOT 


...to run the program. 


Key combinations and commands 

In this version of B-Em, F11 opens the 
menu, navigable using the mouse or arrow keys. 
Press ENTER to select an option and, if it flashes 


TopTip & 


Build for Pico! 


After this tutorial, 
you'll also be set 
to build B-Em for 
Raspberry Pi Pico. 
You'll need a VGA 
board to handle 
graphics output. 


This version of B-Em 
has a stripped- 
down F1a1 menu 

but it includes 
critical sound and 
video options, plus 
embedded disc 
image handling 
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» There weren't many 
consistent standards 
for game or cursor 
control layouts in 
the early 1980s, 
leading to some 
creative approaches, 
demonstrated here 
by Citadel 


V Figure 1 BBC Micro 
keyboard map for 
the UK Raspberry Pi 
keyboard. BBC keys 
are marked in red 


after selection, to confirm it. Press ESC to exit 
the menu or opt out of a flashing selection. The 
pared-down menu gives you sound and graphics 
settings, access to embedded disks, and a hard 
reset. To exit B-EM, close the window or press 
ALT+F4 to terminate the program. 

We've already seen that *. lists the files on a 
disk and EXEC executes a program. You can finda 
helpful lookup sheet for other commands and for 
BBC BASIC in general at magpi.cc/bbcbasic. An 
HTML version of the BBC Micro User Guide exists 
at magpi.cc/bbcuserguide. 


07 Loading disk images 

Although there’s no disk image browser, 
you can launch B-Em to run a specific disc image. 
The .SSD and .DSD formats are supported, these 
are the most commonly used to distribute modern 
BBC games. 

Download Infuto’s Guntus shoot-’em-up from 
magpi.cc/guntus (direct download) and save it to 
your Downloads folder. 

To load it, the command with full paths 
should be: 


~/Pico/b-em/pi_build/src/pico/xbeeb 
~/Downloads/Disc172-Guntus.ssd 


We’ll make some shortcuts to tidy that up later. 
In B-Em list the files by typing *., then load 
Guntus with: 
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CHAIN" GUNT- IN" 


We could also have used *EXEC !BOOT, as a boot 
file is present. 


Embedding disks 

You can also embed disk images at build 
time. By default, B-Em boots with two embedded 
disks: 2048 and the iconic BBC Welcome disk. 
You can switch between them in the F11 menu, 
by going to Disc 0, using the left and right arrow 
keys to navigate to the option you want, then 
pressing ENTER. 

In our ~/Pico/b-em/src/pico/discs/ directory, 
you’ll find a file called beeb_discs.txt, alongside 
several disk images. Add new embedded disks by 
inserting a line at the bottom formatted thus: 


Your Label For The Disk = /path/to/disk/ 
image.dsd 


Alternatively, you can create a file in the same 
directory, called beeb_discs_user.txt, with entries 
formatted in the same way. This will automatically 
supersede beeb_discs.txt. Labels can have spaces; 
paths and file names cannot. 

Once you’ve added your list of files to embed, 
repeat the final make -j4 command in the pi_build 
directory from Step 3. 


Sticks of joy 

Joystick support isn’t built into this version 
of B-Em, but you can use mapping software 
to work around this. AntiMicroX can map any 
recognised joystick, from a Sony DualShock 4 to 
the Pi Pico-powered DB9g joystick adapter we made 
in issue 125, or our older GPIO joystick adapter 
(magpi.cc/dbgjoystick). At the Terminal: 


sudo apt install antimicro 
antimicrox 


A popular control schema for games used Z 
to move left, X to move right, : for up, and / 
for down, with SPACE and RETURN configured 
as jump and/or action keys. If you only have 
one joystick button, assign it to whichever you 
need most often. AntiMicroX supports multiple 
control profiles, so it’s easy to switch between the 
most common. 


dbS_bbe joystick-2 : WRemove — Load Save Save As 


DPads 


n 
a) 
* 

o 
o 
~ 
c) 


A Mapping a controller with AntiMicrox is a convenient 
way of both adding retro joystick support to this 
version of B-Em, and replacing old-school keyboard 
layouts with something more familiar 


A smoother startup 
Let’s add some symlinks and shortcuts 
Open a Terminal and type: 


sudo In -s ~/Pico/b-em/pi_build/src/pico/ 
xbeeb /usr/bin/local 


You can now launch xbeeb by name at the 
Terminal, no path required. You’ll still need 
to provide paths to disc files you wish to 
launch, though. 

We'll also make a desktop launcher. Create a 
text file called b-em.desktop on the desktop, or 
add it to Raspberry Pi OS’s main menu by placing 
it in ~/.local/share/applications. See the code 
listing for the full launcher file. If you want to 
launch from the desktop, embed the disks you use 
regularly, as there’s no file browser. To ensure 
that .desktop files are executed by default, in the 
file manager go to Edit > Preferences and tick 
‘don’t ask options on launch executable file’. 


Getting new software 

There’s a vibrant homebrew scene for 
the BBC Micro. The non-commercial section 
(magpi.cc/bbcnoncomm) of the Complete BBC 
Micro Games Archive is home to 29 games released 
in 2022 alone, plus hundreds of older freeware and 
public domain titles ranging from the 1980s to 
the present. New releases are usually announced 
on the forums of mainline B-Em and BeebEm 
maintainer group Stardot: magpi.cc/bbcstardot. 
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b-em.desktop 


» Language: DESKTOP 


@@1. [Desktop Entry] 

Q@@2. Encoding=UTF-8 

003. Version=1.0 

004. Type=Application 

005. Terminal=false 

006. Name=B-Em 

Q07. Comment=BBC Micro emulator 


@08. Exec=~/Pico/b-em/pi_build/src/pico/xbeeb 


@09. Icon=~/Pico/b-em/icon/b-em.png 


M There's a vibrant homebrew ‘TOPTIP di 


scene for the BBC Micro © 


Learn to program like it’s 1985 

Many of Usborne Books’ classic 1980s 
guides to computer programming are now 
available for free at magpi.cc/usborne1980s. BBC 
Micro projects feature heavily. 

There are even modern publications that 
review and analyse software for 8-bit platforms 
including the BBC Micro, such as The Classic 
Adventurer (classicadventurer.co.uk), while 
historians and enthusiasts have archived 
contemporary magazines and fanzines at sites 
including the Educational Software Archive for 
the BBC Micro (magpi.cc/bbceduarchive), 8BS 
(magpi.cc/8bsmag), and The Internet Archive 
(magpi.cc/microuserarchive). {7 


SURROUNDED BY TREES 


YOU ARE OH A WINDING PATH 
YOU CAN SEE SOME PRETTY PINK FLOWERS 


EXITS ARE SOUTH, WEST 


WHAT WEXT 7 


Now | gm 
the Master 


B-Em includes 

a BBC Master 
emulator, which 
you'll find 

in the same 
directory, with an 
executable file 
named xmaster. 


Modern BBC Micro 
games like Brian 
Tierney’'s Blue 
Wizard are able 

to use impressive 
graphical techniques 
not readily available 
to BBC devs in the 
early 1980s 
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Stewart 
Watkiss 


Also known as 
Penguin Tutor, 


Stewart is a maker 
and YouTuber who 


loves all things 


Raspberry Pi and 


Pico. Author of 
Learn Electronics 


with Raspberry Pi. 


twitter.com/ 


stewartwatkiss 


| You'll Need 


» Breadboard 
magpi.cc/ 
breadboardhalf 


» Battery holder 
magpi.cc/ 
batteryholder 


>» LED 
magpi.cc/ 
diffusedleds 


» 2200 resistors 
magpi.cc/ 
220resistors 


» Jumper wires 
magpi.cc/ 
mmjumpers 


>» PCB switch 
magpi.cc/ 
tactileswitch 


Beginning 
electronics 

with a breadboard 
and an LED 


Get started with electronic projects using simple components. Find 
out what makes the electrons flow using g LED light and switch 


circuits on a breadboard, along with basic 

information you need to know when starting 
out with electronics. Find out how to work out 
which way the LED goes and follow the easy guide 
to find the right-value resistor. Add the switch 
and you have the basics of a first circuit. 


[ n this project, you will learn how to create 


Using a breadboard 

A prototyping breadboard is a way 
of creating electronic circuits by pushing 
components into the board. Using a breadboard 
is a great way to learn about electronics. You 
can use it to create a circuit, swap out some 
components, and experiment with different 
values. When you’ve finished, you pull the 
components out and they can be reused for your 
next project. They are designed so that integrated 
circuits can be plugged into the centre of the 
board, and you can connect components to the 
various pins. Most include power rails that run 
horizontally across the top and bottom, and 
vertical rails with five holes each - see Figure 1. 


Wire up an LED circuit 
You can start by creating a simple circuit 
using a battery, LED, and resistor. You’ll also 
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need some jumper wires, or solid core wire to 
create the complete circuit. Avoid stranded wire 
as that is difficult to insert and the individual 
strands can break off. The wires for battery packs 
normally have stranded wires, but hopefully they 
are tinned, which makes them easy to use. If not, 
then you may need to push them in using one of 
the jumper wires. 

The first circuit is shown in Figure 2. 


Testing the first circuit 

Has the LED lit up? If so great. If not, don’t 
worry: it may be that the LED is the wrong way 
around. We didn’t mention it before, but the LED 
does need to be connected in a certain direction for 
it to work. Using a breadboard means that it’s easy 
to experiment: just unplug the LED and insert it 
with the leads the opposite way around. If the LED 
still doesn’t light, then look for a switch on the 
battery connector or recheck the wiring. 


LED direction 

When using a breadboard, it’s easy to swap 
components around, but it’s not so easy when you 
create a permanent circuit. There are a few ways 
to tell which way around an LED needs to go, the 
easiest (but less reliable) is to look at the length of 
the leads. The longer lead is normally the anode 
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Each hole in a row of (typically 
five) holes is connected to 
each other, with a split in the 
middle where the groove is. 
Putting a component in one 


hole in a row connects it toa 
component in another hole 


Every hole in one of the long columns 
on the side of the breadboard is 
connected all the way across. They're 
often used to provide an easily 
accessible positive and negative ‘rail’ 


which is connected towards the positive side is that the LED 
of the circuit (the red wire from the battery), and must be the correct 
the shorter lead is the cathode which is connected way around. The reason for 
towards the negative side of the circuit (the black this is that it is a semiconductor 
wire from the battery). A more reliable way of device. Semiconductors have special 
determining the anode and cathode is to look for 
a flat area on the body of the LED; the flat area | | 
normally denotes the cathode (negative) side of i With 0 ut th e resisto f th e 
the LED, LED will allow too much 
current to flow and burn 
How the circuit works itself out 
For an electronic circuit to work, there need 
to be connections going from the positive terminal properties that allow them to work as a conductor 
of the battery, through the components, and then or an insulator when certain conditions are met. 
back to the negative terminal of the battery. This In this case, the LED is a type of diode which acts 
completes a full circuit. The additional factor here like a one-way valve. It acts as a conductor when 


Figure 2 


TopTip & 


Datasheets are 
your friend 


eevee eeeveees 


The LED lights up 
when a current flows 
through it, but only 
AAA Battery rs | works in one direction 
] 


Ausyeg VWVV 


Datasheets are 
available for 

most electronic 
components. They 
will provide the 
information you 
need to use them 
in your circuits. 


TAC NO LCL One CL CLL ee, 
A breadboard is a great way eeeeeeerees 


to start electronics; you 
can connect components 
without damaging them 
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AAA Battery —— 1 


Ausqeg vvV 


AAA Battery F 


Auayeg VW 


A Figure 7 The 
updated circuit 
includes a switch 
to turn the circuit 
on and off 


in the forward direction and an insulator when in 
the reverse direction. 


The resistor 

The other component included in the circuit 
is a resistor. As its name implies, this resists 
the current around the circuit. This is needed to 
protect the LED; without the resistor, the LED will 
allow too much current to flow and burn itself out. 

The resistor used in this circuit is 220 Q (ohms), 

but why do we use this value? To understand how 
to choose resistors, you need to understand some 
basic electrical circuit theory. This may sound a 
bit daunting, but you only need to understand the 
very basics. 


LED typical values 


A Figure 4 Typical LED values for voltage and 
current. Check datasheets for non-standard LEDs 
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07 Voltage, current, and resistance 
The three fundamental measurements 

of an electrical circuit are voltage, current, 

and resistance. 

Voltage is the amount of electric pressure. 
Voltage is measured in volts, which uses the 
symbol V. 

Current is the flow of electric charge going 
through a conductor. It is measured in amperes 
(normally referred to as amps), which has the 
symbol A. When used in electronics, the current 
is normally very small, so is often shown in 
milliamps (mA) which are thousandths of an amp. 

Resistance is how much a material opposes the 
flow of electric current. It is measured in ohms, 
denoted by the Greek omega character, Q. You 
may also see values in thousands of ohms, known 
as kiloohms (kQ), or even millions of ohms, 
known as megaohms (MQ). 


Ohm's law 

The voltage, current, and resistance are 
all related to each other. This is all described in 
Ohm’s law. The easiest way to understand this is 
by using Ohm’s law triangle (see Figure 3). This 
has V for the voltage, I for the current, and R for 
resistance. Cover the letter for the value you want 
to find, and you have the formula. If you know the 
current (I) and the resistance (R) but need to know 
the voltage (V), then cover up the V and it leaves 
you with I x R. If you want to know the resistor 
value needed for a specific voltage and current, 
then cover the letter R and you have V = I. 


Calculating the resistor voltage 
and current 
To calculate the resistance required, we first need 
to know the voltage across the resistor. This will 
be the voltage of the battery, minus the voltage 
dropped across the LED. The voltage across 
the LED is specific to the type of LED used, but 
you can use approximate values based on the 
typical values. 

We are using four AA batteries. These are 
normally 1.5V per battery, providing a total of 6V. 
We're using a red LED based on the typical values, 
which is 2V. This gives 6 - 2, which is 4V across 
the resistor. 

The current that the LED requires depends upon 
several factors, including type, size, and brightness. 


4-band resistor colour codes 
[Colour Stanuican figures las [Tolerance 


a i 


A Figure 5 The resistor colour table. For four-band resistors, there 
are two significant figures, a multiplier, and a tolerance band 


We have used 20mA across the table (Figure 4), 
which is a realistic value for a standard 5mm LED. 


Calculating the resistor value 

We now have the voltage across the resistor 
(4V) and current (20mA), so we can use that to 
calculate the required resistance. Using the formula 
R=V+<I, we calculate 4 / 0.02 = 2000. 

You may notice that earlier we specified a 

220 Q, resistor. This was not a mistake. You can 
indeed use a 200 resistor, but they are less 
commonly available. 


Mm The current that the LED 
requires depends upon 
several factors, including 
type, size, and brightness 


Resistors are available in different values, but 
it would be impossible to have resistors for every 
calculated value. There are different series of 
values known as E-series. Your author normally 
uses E12 series, which provides a reasonable 
selection of values, with the nearest values being 
180 Q, or 220... We’ve chosen the higher value, as 
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A Figure 6 Many 
switches have 
four pins. The pins 
on each side are 
connected together, 


with the switch going 
between them 


that is safer than risking too high a current. The 
value we used is 220. 


How to recognise the correct 

resistor 
If you look at the resistors, they don’t include the 
resistance value written on them. Instead, they 
normally use bands of different colours. A resistor 
will normally have four or five bands of colour. 
The four-band variant is the most common, so 
we will explain that. There is usually a bigger gap 
between the third and fourth bands so you know 
in which order to look at the resistor. 

The first and second bands denote the first and 
second significant figure of the value, followed by 
the third band which is a multiplier (effectively 
the number of zeroes after the first and second 
values). For our 220, resistor, it will be red (2), 
red (2), followed by brown (x10). The fourth band 
is the tolerance, which for E12 resistors is often 
gold (5%). See Figure 5. 


AX 
/\_|R\ 


A Figure 3 The 
Ohm's law triangle, 
makes it easy to 
find the formula 
for calculating 
resistance, 
voltage, or current 


Add a switch 

At the moment, the circuit 
stays on all the time. You can adda 
switch to the circuit so that it only 
comes on when this is pressed. This 
requires a push-to-make switch, 
which is one which completes the 
circuit when the switch is pressed. 

These switches normally have 

four pins, but these are wired in 
two pairs, as shown in Figure 6. 
When you insert these into the 
breadboard, the pins on the left 
are connected, as are those on the 
right. Just remove the jumper wire 
going to the resistor with a wire 
from the supply to one side and 
connect the other side of the switch 
to the resistor (Figure 7). [7 


<4 The LED needs to 
be connected the 
correct way around. 
Look for the longer 
lead (anode) or the 
flat area (cathode) 
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Oo @ Home - botsin.space x + 


€ G ©) https://botsin.space/ 


*mastodon 


# Home 


¥| bens_picow 


another test post from Pico W 


iy bens_picow 


another test post from Pico W 


| bens_picow 


another test nost fram Pico W 


Getting online with a microcontroller 


aspberry Pi Pico W microcontroller 
has just got support for 
CircuitPython. Let's take a really quick 
look around. 

For the most part, using Pico W is 
exactly the same as using Pico. The 
Ben Everard pinout is the same, and you'll have exactly the same 
features available. However, you also have added 
network connectivity. 

First, you need to get the software. You can 
download a UF2 file of CircuitPython for Pico W from 


W @ben_everard 


Ben's house is slowly 
being taken over by 3D 


printers. He plans to hsmag.cc/PicoWCircuitP. At the time of writing, the 
solve.this by printing an latest version was 8.0.0-beta.4. There wasn't yet a 
extension, once he gets : . ; 

enough printers. stable version for Pico W. This should be fine for most 


cases, but obviously, a beta version might have bugs in 
it. The stable version should be available shortly. 
In order to get that onto Pico W, you need to 


Above © ; hold down the BOOTSEL button, then plug Pico W 
The Mastodon social ; ee ak . 
network has an API into your computer (unplug it first, then plug it 
that Sisasy-to‘connect in). You should see a new removable drive appear, 
to and use from : 5 
embedded devices and you can drag and drop the UF2 file onto this. 


56 | magpicc | Pico W with CircuitPython 


@ Home 

A Notifications 

Q Search 

Local 

@ Federated 
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RA Bookmarks 
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Pico W with CircuitPython 


It should disappear and a new CircuitPython drive 
should pop up. 

If you have not used CircuitPython before, 
then there is a good ‘getting started’ guide at 
hsmag.cc/AdafruitCircuitP. 

For our first experiment, let’s try interacting with 
the social media network du jour, Mastodon. You'll 
need a Mastodon account for this. It can be a personal 
account, or you can set one up just for your bot. In 
fact, there's a Mastodon instance set up specifically for 
bots — botsin.space. Be sure to read the rules so you 
can properly write your request if you want an account 
on that instance. If you're looking to set up a personal 
account, you'll need to pick an instance to join. Head to 
joinmastodon.org to look at the options. Don't worry 
too much, as you will be able to move your account 
to a different instance later if you want, and you can 
interact with people on any instance. 

Once you've got an account, you can get an API 
key. In your edit profile page, go to Development, 
then click on New Application and give it a name, then 


@©Mu 1.03 - code py* 


Goa 


1 import microcontroller 

2 import socketpool 

2 import wifi 

+ from temperature_html import temperature_html 

s from adafruit_httpserver import HTTPServer, HTTPResponse 
« from secrets import secrets 
’ 
‘ 
. 


ssid = secrets["WIFI_SSID"] 
print("Connecting to", ssid) 
wifi.radio.connect(ssid, secrets["WIFI_PASSWORD"]) 
print("Connected to", ssid) 


pool = socketpool.SocketPool (wifi.radio) 
server = HTTPServer (pool) 


dserver.route("/temperature") 
def base(request): 


return HTTPResponse(content_type="html", body=temperature_html1. format(temperature=microcontroller.cpu, temperature) ) 


au print(wifi.radio. ipv4_address) 
2 

a while True: 

” try: 

= server.serve_forever (str (wifi.radio. ipv4_address) ) 
* except: 

Fo pass 


Adatruit GecutPython REPL 
WUUe SlUppeu by aULOmTeludU. ReELUdUTTIgR SUUt. 


Auto-reload is on. Simply save files over USB to run them or enter REPL to disable. 


code.nv outout: 


press Submit. You'll get redirected to the application 
list page. Click on the name of your new app, and this 
should take you to the details page where you'll see 
the access token for this app. You'll need this shortly. 

Posts on Mastodon are short bits of text. Exactly 
how short depends on your instance, but 500 
characters is pretty common. They can also have 
images or video attached to them, but we won't worry 
about that at the moment. 

Let's look at the code to create a post on Mastodon. 


import microcontroller 

import socketpool 

import wifi 

import adafruit_requests as requests 
import ssl 

from secrets import secrets 


ssid = secrets["WIFI_SSID"] 
print("Connecting to", ssid) 
wifi.radio.connect(ssid, secrets["WIFI_PASSWORD" ]) 
print("Connected to", ssid) 


pool = socketpool.SocketPool (wifi. radio) 
requests = requests.Session(pool, ssl.create_ 
default_context()) 


response = requests.post("https://botsin.space/ 


In the first example here, we used a POST request to 
send data to an external server. In the second example, 
we set up a server and got data from it. You might be 
wondering if it's possible to combine the two and use 
POST requests to send data to Pico W. The answer is: 
yes, you can. 

We don't have space to go through it all here, but Liz 
Clark has written a guide to this for Adafruit— you can 
see it at hsmag.cc/PicoWHT1PServer. 


api/v1/statuses", 
headers={"Authorization" 
secrets["mastodon_access_token" ]}, 
data={"status": "another 
test post from Pico W"}) 


As you can see, this uses the Adafruit requests 
module that can be used much like Python 3's 
requests module. You just need to make sure that you 
copy it over the adafruit_requests folder from the 
CircuitPython Library Bundle (which you can download 
from circuitpython.org). 

You will also need to create a secrets.py file. 
This will contain all the things that you don't want 
to be public, including your Wi-Fi password and 
Mastodon key. > 
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Left > 

You can build an HTTP 
server in under 30 
lines of CircuitPython, 
so it’s an easy way of 
adding an interface to 
your project 
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Below & 

OK, this isn’t the 
best-looking website, 
but it gets the 
information across 


oO ha) The Temperature 


= -@ 


A Not secure 


ESPHome is a platform for building and 
interconnecting DIY Internet of Things devices. As 
the name suggests, it was originally built for ESP8266- 
and ESP32-based devices. However, there’s now 
support for Pico W. This gives you a really easy low- 
code way of linking up sensors, actuators, and other 
‘thing’ devices. You can create configurations in the 
YAML markup-language and deploy these to devices. 
Using this, you can very quickly make a network of 
interconnected things using commonly available 
maker components and control them from the Home 
Assistant smart home software. 


The format should be: 


secrets = {"WIFI_SSID" : 


"WIFI_PASSWORD" : 
"mastodon_api_key" : 


"<your ssid>", 
"<your password>", 
"Bearer <your token>" 


In most of these cases, you just need to slot in the 
appropriate bit of secret information. The Mastodon 
token is a bit different just because you need to include 
the word ‘Bearer’ before the token. 

Once you've set this up, you can save the above 
code as code.py on your Pico WV, and it will connect to 
your Wi-Fi network, post the message to Mastodon, 
and then finish. This is probably a little dull by itself, but 
you can use it to log information, send messages, or 
just generally to scream into the void. 


x ie 


10.10.42.133/temper 


The Temperature 


The temperature is 22.46 
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AT YOUR SERVICE 

The second thing that we're going to look at is setting 
up a simple HTTP server. This will let you connect to 
Pico W and read information about what's going on. 


import microcontroller 

import socketpool 

import wifi 

from temperature_html import temperature_html 
from adafruit_httpserver import HTTPServer, 
HTTPResponse 

from secrets import secrets 


ssid = secrets["WIFI_SSID"] 
print("Connecting to", ssid) 

wifi. radio.connect(ssid, secrets["WIFI_ 
PASSWORD" ]) 

print("Connected to", ssid) 

print(wifi. radio. ipv4_address) 


pool = socketpool.SocketPool (wifi. radio) 
server = HTTPServer(pool) 


@server.route("/temperature" ) 
def base(request): 

return HTTPResponse(content_type="html", 
body=temperature_html. 
format (temperature=microcontroller.cpu. 
temperature) ) 


while True: 
try: 
server.serve_forever(str(wifi. radio. 
ipv4_address)) 
except: 
pass 


There's a slightly unusual bit of syntax in the line 
@server.route("/temperature"). This is called a 
decorator, and you put them before methods. They're 
not used that much in CircuitPython, but are a bit more 
common in regular Python. Essentially, they are a way 
of wrapping a method up in another bit of code. We 
won't go into everything you can do with decorators, 
but in this case we're using the server.route method 
to register the method base with the server at the 
location /temperature. This way, anyone who visits 
http://<server_IP>/temperature will see the output 
of this function. 

We use the HTTPResponse method (that we've 
imported from HTTPServer) to create this response. 
This method takes care of most things; we just have 
to tell it that we can't return HTML and that the 
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name: awesome 
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body of the response should be a formatted version 
of temperature_html. 

When working with web pages, we're going to 
need to manipulate quite a bit of text. This isn’t a 
huge problem from a processing point of view, but 
we want to be a bit careful of how we manage our 
files to ensure that they're not too messy. There are 
a few ways of doing this, but we've stored the HTML 
in a string in another file and so are importing that 
string from the file. We're using Python's built-in string 
formatting tools to insert data into this HTML string. 
In its simplest form, this lets us put {0} in the string 
somewhere, and then the format method will replace 
this with the first parameter to format. If you want to 
insert more bits of text, you can add {1}, {2}, etc. to 
the string and use extra parameters to format to inset 
these into the text. The temperature_html.py file is: 


temperature_html = """ 
<html><head><title>Temperature</title></head> 
<body><h1>Temperature</h1> 

<p>The temperature is: {0} degrees C</p> 
</body> 

</html> 


HTML is a markup language for creating web pages. 
We're not going to go into it too deeply here, but very 
simply, text is encased in tags with angled brackets. 
A/ tag closes the brackets. There's a <head> section 
with things like the title, and the body which is the 
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to physically plug in a cable 


main text of the page (and not to be confused with the 
body of the HTTP request which includes the whole of 
the HTML). 

<h1> is heading level 1 (i.e. the largest heading); <p> 
is a paragraph. 

With all that in place, we just need to kick off our 
server with server.serve_forever(str(wifi. radio. 
ipv4_address)). We've wrapped this up in a try-except 
block in an infinite loop. This is in case there are any 
problems while it’s running. HTTP servers don't have 
to be particularly complex, but there's a lot of things 
that can behave strangely in there. The network could 
lose packets. The client requesting the data might send 
a poorly formed request, or there could be a bug in our 
code. This will just attempt to restart the server should 
anything go awry. It might not last forever, but it will 
make it a bit more resilient. 

There we have it. A simple HTTP server for 
interacting with a Pico W. You can use it to build up 
complex interfaces and easily get data out of your build 
without having to physically plug in a cable — which can 
make the physical setup much easier. We've looked 
at the most basic use case here, but it can get as 
complex as you like. O 
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Make a giant 
Pomodoro timer | 
using Galactic Unicorn 


Go large or go home with this jumbo-sized timer for getting more done 


Nik Rawlinson 


Coffee-drinking 
typewriter lover 
with a penchant for 
pencils and paint. 
Frequently found 
staring at the sea 
from the back of 

a camper-van. 


nikrawlinson.com 


[ You'll Need 


» Galactic Unicorn 
magpi.cc/ 
galacticunicorn 


» Thonny. Comes 
with Raspberry 
Pi OS; download 
for other 
platforms from 
magpi.cc/thonny 


system of effort and reward: work for 25 
minutes and you get five minutes off. After 
every fourth block of work, you can rest for 20 
minutes. That’s it. But, if you’re keeping track 
of those blocks with the timer on your phone, 
it’s easy to miss a break - or to get so distracted 
actually playing with your phone that you get 
nothing done. In this tutorial, we’ll solve both 
of those problems by using the stunning Galactic 
Unicorn to build a dedicated Pomodoro timer that 
automatically alternates between work and rest 
periods. Press button A on the back to start it, C 
to manually switch between work and rest, and D 
to end the cycle altogether. 


T he Pomodoro technique is a simple 


Set up the environment 

The first four lines of our pomo.py code 
(listed overleaf) import the libraries needed for 
our routine. We then create a frame buffer, called 
buffer, in which we can temporarily stage any 


A We'll use buttons A, C, and D to control the Pomodoro timer 
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graphics we want to send to the display before 
committing them to the LEDs. We then declare 
the variable gu, which represents the Galactic 
Unicorn in our routine, and store its width in the 
variable displaywidth. We’ll use that width to 
calculate the panel’s midpoint when we want to 
centralise text later. 


Define three routines 

We've split the bulk of our code into 
three functions: cycle(), f111(), and empty(). 
The cycle() function manages the transition 
between fi11() and empty() and keeps track of 
whether we’re in a Pomodoro work cycle or rest 
cycle. The £111() function handles wiping and 
then illuminating every pixel on the display ina 
subtle red-biased gradient for a work cycle, anda 
green-biased gradient for a rest cycle. The empty() 
function extinguishes each LED in turn, at a rate 
determined by the period: work, rest, or extended 
rest. Let’s take a look at the cycle() function in 
more detail. 


The cycle() function 

Our first job, on line 19, is to define a flag - 
called killswitch — and set its condition to True. 
As you’ll see from line 23, we’ve set the cycle() 
function to carry on repeating so long as that 
condition doesn’t change. We’ve also established 
a counter, called tally, which will increment by 
one at the end of every work cycle. Why? Because 
most Pomodoro routines allow for five minutes 
of rest after a regular work cycle, and 20 after 
every fourth work cycle. By keeping track of how 


There's an integrated 
Raspberry Pi Pico W around 
the back that runs our code 


many work cycles we’ve completed, we can check 
whether the number stored in tally is a multiple 
of four when we get to the empty() function. 


Explain what's happening 

Lines 24 to 30 tell the user what’s going 
on. We set the pen colour to hot pink, having 
previously assigned that value to the variable fg 
(for foreground) on line 12, then measure the 
width of our message, which happens to be “Go 
get ’em”. We subtract the message length from 
the width of the Galaxy Unicorn display and divide 
the result by two. The result of this calculation 
gives us the position of the left-hand margin 
necessary for centralising the text on the display. 
We then use: 


utime.sleep(1) 
...to pause for a second, which should be long 


enough to read the display before calling the 
£111() function. 


Clear the display 

When calling fi11(), we pass it the variable 
‘type’. This variable is used throughout the 
code, and will always be set to either ‘work’ or 
‘rest’. It’s used to define both the colours used to 
illuminate the LEDs (in the £i11() function), and 
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Galactic Unicorn has 583 
bright, colourful LEDs that are | 
easy to see from a distance | 


the interval between each LED blinking out (in the 
empty() routine). The fi11() function’s first job 

is to wipe away the instructions we just gave the 
user, so it first switches to the black pen, which 
we assigned to the value bg (for background) on 
line 13, then works through each of the 53 columns 
and 11 rows, turning off each pixel in turn. We 
could have blanked the whole screen at once using 
the command: 


buffer.clear() 


...but doing it one pixel at a time, with a very 
slight pause between each LED, is a more visually 
interesting option. 


™m We subtract the message length from 
the width of the Galaxy Unicorn display 
and divide the result by two 


Rainbows everywhere 

Once every light has been extinguished, we 
light them up again. Notice how, on lines 45 to 
47, we set the values for red, green, and blue to 
maximum (255 each). If we used these values to 
illuminate the LEDs, every light on the board would 
be white. That would be boring. Instead, we want 
to introduce a rainbow or gradient effect, so on 
lines 60 and 62 we reduce the strength of the green 
tone if it’s a work cycle, and the red tone if it’s a 
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P As Raspberry Pi 
Pico W is on board, 
there's no need to 
solder any headers 


TopTip & 


Add audio 


The Galactic 
Unicorn has a 
built-in speaker, 
which you can 
address using 

the PicoSynth 
library (magpi.cc/ 
picosynth). 


m With every LED 
illuminated, we're returned 
to the cycle() function @ 


rest cycle, by dividing the maximum strength of 
either by 53 (the number of columns of LEDs) and 
multiplying the result by the column number to 
deliver a gradient. Again, we pause briefly between 
each LED being illuminated, purely for effect. 


07 Check the killswitch 
With every LED illuminated, we’re returned 
to the cycle() function, which immediately 
calls the empty() function in a way that will 
pipe any value returned by that function to our 
killswitch variable: 


killswitch = empty(type, tally) 


This way, we can check whether the killswitch 
was activated while the empty() function was 
running. Notice that, at the same time, we’re 
passing two variables to empty(): type and tally. 
That’s so empty() knows how long to leave 
between each LED going out, and whether we’ve 
earned ourselves a longer rest period. 
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Mind the gaps 

Lines 78 to 81 effectively set the delay 
between each LED extinguishing to 2572ms (2.572 
seconds) and 515ms (0.515 seconds) for work and 
rest cycles respectively. We then test whether the 
number stored in the tally variable is a multiple 
of four on line 83, and, if it is, we extend the gap 
between each LED going out in the upcoming rest 
period to 2058ms (2.058 seconds). Multiply each 
of these timings by 583, which is the total number 
of LEDs on the board, and you’ll see how long each 
cycle lasts. A work cycle is 1,499,476ms (1499.476 
seconds, or 24.99 minutes), a regular rest cycle 
is 300,245ms (300.245 seconds, or five minutes), 
and an extended rest cycle is 1,199,814ms 
(1199.814 seconds, or 19.99 minutes). 


Test for button presses 

Between lines 57 and 109, we extinguish the 
pixels one at a time, starting at the bottom right 
of the board and ending up at the top left. Notice 
line 92: 


for zzz in range(delay): 


This is where our calculations come in. Rather 
than pausing for 2058ms at a time between each 
work cycle LED, the function actually repeats 2058 
times, pausing for 1ms (0.001 seconds) each time, 
and testing to see if button C or D on the back of 
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pomo.py 


DOWNLOAD 
THE FULL CODE: 


» Language: Python 


y) magpi.cc/pomopy 


001. import math 

002. import utime 

003. from galactic import GalacticUnicorn 

004. from picographics import PicoGraphics, 
DISPLAY_GALACTIC_UNICORN 

Q05. 

@06. # define buffer handling elements 

007. buffer = PicoGraphics(display= 
DISPLAY_GALACTIC_UNICORN) 

@@8. gu = GalacticUnicorn() 

@09. displaywidth = GalacticUnicorn.WIDTH 

Q10. 

@11. # define colours and font 

@12. fg = buffer.create_pen(255, 20,147) 

@13. bg = buffer.create_pen(@,2,0) 

014. buffer.set_font("bitmap8") 


Q15. 

@16. def cycle(type): 

Q17. 

e18. #set initial variables 

e19. killswitch = True 

@20. message = "Go get ‘em" 

21. tally = @ 

Q22. 

23. while killswitch: 

24. buffer.set_pen(fg) 

@25. width = buffer.measure_text(message, 1) 

26. display _size = GalacticUnicorn.WIDTH 

@27. start_position = int( 
(display_size - width) / 2) +1 

28. buffer.text(message, start_position, 2, -1, 1) 

@29. gu.update(buffer) 

030. utime.sleep(1) 

Q31. 

Q32. fill(type) 

Q33. 

Q34. killswitch = empty(type, tally) 

Q35. 

36. if type == "work": 

037. tally = tally + 1 

38. type = "rest" 

39. message = "Break time!" 

040. else: 

041. type = "work" 

042. message = "Go get ‘em" 

043. 

044. def fill(type): 

Q45. red = 255 

046. green = 255 

047. blue = 255 

048. 

049. #erase status message 

Q50. for a in range(53): 

e51. for b in range(11): 

@52. buffer.set_pen(bg) 

Q53. buffer.pixel(a, b) 

Q54. gu.update(buffer) 

@55. utime.sleep(@.9001) 

Q56. 

Q57. #fill with red to yellow or blue to green rainbow 

058. for x in range(53): 

@59. if type == "work": 


060. 
061. 
062. 
063. 
064. 
065. 


066. 
067. 
068. 
069. 
70. 
071. 
072. 
073. 
074. 
75. 
076. 
077. 
078. 
079. 
080. 
081. 
082. 
083. 
084. 
085. 
086. 
087. 
088. 
089. 
090. 
91. 
92. 
093. 


994. 
95. 
096. 
097. 
098. 
99. 


100. 
101. 
102. 
103. 
104. 
105. 
106. 
107. 
108. 
109. 
110. 
111. 
112. 
113. 
114. 
115. 
116. 
117. 
118. 


green = int(4.81 * x) 
else: 

red = int(4.81 * x) 
for y in range(11): 

blue = int(4.81 * y) 

dotpen = buffer.create_pen( 

red, green, blue) 

buffer .set_pen(dotpen) 

buffer.pixel(x, y) 

gu.update(buffer) 

utime.sleep(@.0001) 


def empty(type, tally): 
#set variables 
row = 10 
column = 52 
buffer.set_pen(bg) 


#calculate rest between each LED extinguishing 
if type == "work": 


delay = 2572 

else: 
delay = 515 

if ((tally & 3) == @) and type == "rest": 
delay = 2058 


#blink out one pixel at a time 
while row > -1: 
while column > -1: 
buffer.pixel(column, row) 
gu.update(buffer) 
column = column - 1 
for zzz in range(delay): 
if gu.is_pressed( 
GalacticUnicorn.SWITCH_C): 
buffer. set_pen(bg) 
buffer.clear() 
gu.update(buffer) 
killswitch = True 
return killswitch 
elif gu.is_pressed( 
GalacticUnicorn.SWITCH_D): 
buffer.set_pen(bg) 
buffer.clear() 
gu.update(buffer) 
#set termination flag 
killswitch = False 
return killswitch 
else: 
utime.sleep(@.@01) 
column = 52 
row = row - 1 
killswitch = True 
return killswitch 


while True: 
while gu.is_pressed(GalacticUnicorn.SWITCH_A): 
buffer. set_pen(bg) 
buffer.clear() 
gu.update(buffer) 
cycle(“work") 
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the Galactic Unicorn has been pressed. If either has 
been touched, the function ends and we return to 
cycle(). For regular and extended rest cycles, the 
function repeats 515 and 2058 times respectively. 


the status line at the bottom right of the Thonny 
window and select ‘MicroPython (Raspberry 

Pi Pico)’, then click the play button on the 
Thonny toolbar. 


How it all began 

If it was button C that sent us back to 
cycle(), we switch between the work and rest 
routines (or vice versa) and, as the killswitch flag 
hasn’t yet been set to False, the loop continues. 
However, if it was button D, the flag will be set 
to False, and the loop will terminate. We’ll be 
returned to the code that called cycle() in the first 
place, which is the six lines from 113 to 118, at the 
very end of our script. This puts the integrated 
Raspberry Pi Pico W into a watchful state, where 
it’s waiting for someone to press button A. When 
someone does this, it makes sure the screen is 
blank, then launches cycle(), and we’re back 
where we started. 


Test your code 

To copy the code to your Galactic Unicorn, 
make sure the board is connected to your 
computer, paste the code into Thonny, then click 
File, followed by Save As. Click Raspberry Pi Pico 
on the dialog, then save it on the device using 
any name you choose, such as ‘pomo.py’. To run 
it from Thonny but on the Galactic Unicorn, click 


Run at boot 

If you want to be able to run the timer 
when your Galactic Unicorn isn’t connected to 
a computer, make sure you save the code as 
main.py, on the device itself. As there is already 
a routine called main.py on board, Thonny will 
ask if you’re sure you want to overwrite it. Click 
Yes (you may want to make a copy first in case 
you ever want to reinstate it). Once the script has 
been saved, you can unplug your Galactic Unicorn 
from the computer and plug it into a regular USB 
adapter to run the Pomodoro timer wherever 
you choose. f/ 
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@ Although our project 


doesn't use it, the 
Galactic Unicorn has 
a built-in speaker 
that could be used 
to sound an alert 
between cycles 
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Something 
smaller 


If you don't have 
space for Galactic 
Unicorn, you 
could code a 
similar timer using 
a smaller board 
like the Pico 
Unicorn (magpi. 
cc/picounicorn). 


A Once we know the size of the display, we can work out the midpoint for centralised text 
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#MONTHOFMAKING 
ASK THE 


EXPERTS 


Top tips from expert makers to 
help you with your next project 
By expert writer Rob Zwetsloot 


The MagPi community far and wide to make 

something and share their progress online. 
This collaborative build event can be joined by 
anyone and with any kind of project you wish! 
Features editor Rob will be sewing himself. 

This year, we thought we’d ask some expert 
makers about their specialty subject. Flip through 
to get inspired and maybe build your dream 
project this March. 

See y’all online. 


| t’s that time of the year again - time for 
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#MONTHOFMAKING 


Work on a project, new or old 
Take photos of your progress and completed projects 
Share it to Twitter, Mastodon, and/or Instagram with a helpful description 


Make sure to include the #MonthOfMaking hashtag 


That’s it! 


If you don't have social media, you can always email your projects to magpi@raspberrypi.com 
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Allie Katz 


Allie is a YouTuber and creative technologist who 


3D PRINTING 


EX? Eas 


Turn ideas into physical objects 
with these top 3D printing tips 


does a lot of 3D print designing and... printing. 
They’re a pro at turning an idea into a real thing, 
and they also work with ceramics and wearables! 


katzcreates.com 


.  —_ 


Q: How did you start with 3D printing? 

A:A friend and a generous gift for the most part! 
A friend of mine showed me his 3D printer, 
lighting a bit of a flame in me to want to try 
it myself and resulting in it becoming the top 
thing I wanted to get for myself. Amazingly, I 
received my first 3D printer as a birthday gift, 
and as they say, the rest is history! 


Q: What are some of your favourite prints 
you’ve done? 
A: [ve got a pretty deep love for Big Buff Pikachu 
designed by Chan Yen Yee; that was one of my 
early prints. It’s just 
so silly and beautiful 
and fun. Beyond that, 
I get kind of boring 
rather quickly as I 
think most of my 
favourite prints are 
practical things I’ve 
designed for myself 
to make my life 
easier, like my DIY 
Teleprompter: 
magpi.cc/prompter. 
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Q: What do you think is an important thing for 
makers to consider? 

A:1 think an often overlooked consideration 
when it comes to 3D printing is to know your 
printer. Not everyone’s printer can do the 
same thing, and I don’t just mean in terms of 
size limitations! Knowing what your printer is 
capable of, where its strengths and weaknesses 
are, will save you a lot of time and wasted 
plastic later when it comes to printing things. 
Building out custom printing profiles that work 
with these strengths and weaknesses as well will 
save you a lot of time later! 


Q: Are there any ways to practise designing 
and/or printing? 

A: Start small and work your way up to bigger and 
more complex things. Test and calibration prints 
are a great way to get to know your printer’s 
capabilities and limitations, but if you find that 
uninteresting and want to be designing and 
printing your own things, then try tackling one 
difficult thing at a time, instead of trying to 
throw it into a single design. I also recommend 
reading up on the basics/theory of 3D printing 
before diving in too far, particularly since there 
are some amazing, very easy-to-digest primers 
out there. I highly recommend Billie Ruben’s 
guides: magpi.cc/3druben. 
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chance that the physical pieces won’t fit together when printed. 
As mentioned before, all printers are different, and it’s key to 
know what your printer is capable of!” 

0 Planning out a 3D print 
Ee “Think about what you 
want/need and ask yourself the 
question: is 3D printing best for this? 


03 Printing 


“Tf designing anything with parts that fit together or 


If you need something that is small, very detailed, or requires has specific size requirements, print prototypes that test one 
certain properties that will be well served being plastic, particular aspect before printing the whole piece at full quality! 
then 3D printing is likely the best solution! It’s important to Printing only a certain part of a piece if you’re testing the fit, 
recognise though that not everything is best 3D-printed, and or a piece with infill only (no top or bottom layers) to check on 
having a good understanding where 3D printing is ideal is sizing, are great examples of how you can print faster and less 
incredibly useful!” material-dense prototypes before jumping into the final piece.” 


a ayy 


rh) Designing a 3D print 

Es “Always keep your printer’s tolerances in mind while 
designing pieces that need to fit together (or into something 
else)! There will always be a small amount of space ‘lost’ when 
3D printing because 

of nozzle inaccuracies 
and thermal expansion 
of the plastic, and if 
you don’t create gaps 
between your pieces in 
the design software, 
there’s a very good 


K | K 

3D printing, electronics, sensors, wearables 
Make sure the air you're breathing above your 
neck is good, and also make it fashion. 
magpi.cc/3dnecklace 


3D printing, electronics, sensors, wearables able 
After a lengthy hospital stay, Allie made these 
badges to thank their nurses. 


magpi.cc/3dbadge 


3D printing, web services, programming, 

PCB design 

This cute robot from Adventure Time helps keep 
Allie’s 3D printer running. 
magpi.cc/bmoctoprint 
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ROBOTICS 


i A? EH 


Automatons, rovers, and arms; 
there's a lot you can make under 
the robotics umbrella 


Kevin McAleer 


Friend of The MagPi Kevin McAleer is a 
master of robotics, wowing us nearly 


weekly with a new robot (or just a cool 
coat for his dog). He shows his process 
on his YouTube channel, a great resource 
for learning about robotics in itself. 
kevsrobots.com 


Q: How did you start with robotics? 

A:1 started building robots with a single blinking 
LED on an Arduino, this quickly moved onto 
buzzing buzzers, moving servos, and detecting 
light with photosensors. Then I bought a 3D 
printer, and this changed everything: I was able 
to download 3D-printable robots and started to 
learn more about how to make them (it’s how 
smarsfan.com came into being). 


Q: What are some of your favourite robots? 

A: My favourite robots are small, 3D-printable 
robots that you can build and modify yourself. 
These include OpenCat, OttoDIY, SMARS 
(obviously), and Danielle Boyer’s Scobots. I love 
Raspberry Pi Pico, Pico W, and full Raspberry 
Pi robots such as the Pimoroni Trilobot. All the 
robots I build use MicroPython, too, because its 
so easy to read and write. 


Q: What are some great kits for starters? 

A: The Trilobot (magpi.cc/trilobot) is a great 
starter kit, and can utilise the Raspberry Pi 
Camera Module to detect objects. 
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I designed the BurgerBot for beginners; its easy to 
construct and runs on either a Pico or Pico W, with 
parts from Pimoroni (see magpi.cc/burgerbot for 
the bill of materials). 


CuteBot (magpi.cc/cutebot) from Elecfreaks 
(micro:bit-based robot). 


Kitronik Autonomous Robotics Platform for Pico 
(magpi.cc/picorobotics). 


Q: What are some things people tend to forget? 
A: Start small, work on one problem at a time, 
and don’t be afraid to ask for help. 

Robotics is a deep topic, and can be a bit 
overwhelming, but don’t give up! Look to your 
strengths in the three skill areas: mechanics, 
electronics, and programming. This will 
also help you understand where you need to 
develop your skills. (I’m still working on my 
electronic skills.) 


01 Planning 

Whether you’re building your 
first robot from scratch or gearing up 
for a Pi Wars contest, Kevin has this 
to say about robot planning: “What 
do you want to achieve? What should 
the robot do (and what are the bonus 
stretch goals)?” 


0 Designing 

Ee “How will you make the robot 
do these things, what kit do you need, 
and what do you need to learn? Will 
you build this or buy it? I like to draw 
a sketch of the robot, and make a 

list of what it should do, in my robot 
lab notebook.” 


rh) Building 

= “Have a project box to keep all 
the bits together and understand that 
building is an iterative process - none 
of my robots are finished! Decide on 
what is good enough when building. 
Think about the parts you’ll need, the 
tools and materials you need, and time 
in your week when you can concentrate 
on building it.” 


Robotics, 3D printing, sensors, spookiness 
This Halloween decoration truly sends shivers 
down our spines. 


magpi.cc/spookyskele 


— ay 


~ 


Robotics, 3D printing, servos, non-traditional 
locomotion (it walks) 

This Pico-powered feline walks on its four 

legs using a series of servos, and also has an 
ultrasonic distance sensor so it can, feasibly, 
not bump into you. 


magpi.cc/picocat 
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Robotics, 3D printing, ROS, Lidar 
Alittle experimental robot that uses Robot 
Operating System (ROS) on a Raspberry Pi 4. 


magpi.cc/cubie1 
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RETRO GAMING 


i Ag? Ea FF 


Time to build your dream arcade 
cabinet or portable gaming device 


K.G. Orphanides 


K.G. Orphanides is The MagPi’s resident 
retro game writer, and you may have 


seen their regular tutorials on how to 
emulate an old console, or replicate a 
classic control scheme that works with 
modern hardware. 
magpi.cc/hauntedowlbear 


7 


Q: How did you get into retro gaming? 

A: When I started, it was just ‘gaming’, thanks! 
My family won an MSX in a raffle when I was 
seven, and my mum, an IT worker, taught me 
how to program in BASIC. Then she borrowed 
an XT from work until we saved up enough for 
our own 286. I kept using PCs and picked up 
other computers and consoles cheaply as they 
went out of fashion. I vividly remember going 
on eBay as a teen in the late 1990s and sending 
envelopes of dollars off to the US in exchange 
for giant boxes of remaindered classic DOS 
games that reached me on a very slow boat, with 
very cheap postage. 


Q: What kind of projects do retro gaming 
enthusiasts work on? 

A:1 love emulation for the way it’s kept old 
platforms and games relevant, for how 
accessible it is, and for the way it provides a 
window into the past. 

Or you could buy or salvage old computers 
and consoles, or build a Pentium II or Athlon K7 
based PC running FreeDOS. But platforms like 
Raspberry Pi (software emulation) and MiSTer 


f pase ee 
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FPGA (hardware emulation) mean you can 
build dedicated systems for running old games 
without the aging equipment. 


Q: What are some of your favourite projects? 

A:1 love 1980s and 1990s audio hardware, so 
making an emulated USB version of a Roland 
Sound Canvas (my favourite sound card range) 
with mt32-pi (magpi.cc/mt32pi) was a blast. 

I had no idea how much I wanted and needed 
an arcade cabinet in my life until I built one. 
You’ll find that, along with a few of my other 
makes (like the DIY CD-ROM console I made to 
play my PS1 game discs!), in Retro Gaming with 
Raspberry Pi (magpi.cc/retrogaming). 


Q: How do you find games to run on emulators? 

A:Itch.io is your friend! Just search for the 
platform you’re interested in, like NES, C64, ZX 
Spectrum, or MSX! 

If you’re after official digital releases of old 
commercial games for DOS and Windows, GOG 
(gog.com) and Zoom Platform (magpi.cc/zoom) 
should be your first ports of call. 

Indie Retro News (indieretronews.com) 
announces new releases across most major 
8- and 16-bit retro computers, consoles, and 
fantasy consoles. 


2400 ENA CENTER 


STEPS 
TO MAKE 


Planning 

“Make things that bring you joy! It should be fun 
to build, fun to have or, ideally, both. Planning is playing! 
While working out what I want to make, I’ll research and 
experiment in software often just on my desktop workstation, 
often while procrastinating other work. 

When I’m writing a project guide, I usually test all possible 

permutations of the software on the hardware I have in order 
to pick the one that produces the best result.” 


Parts 

“Make sure all the 
hardware and software 
you want to use is actually 
compatible! Your available 
hardware should generally 
determine what software you 
use. I’m a firm believer in 
recycling and reusing as much as possible. Actually paying 
money for new hardware is sometimes required, but some 
of my favourite builds reused old stuff I have around (a CRT 


K.G.'S PROJECTS 


y Build a MicroPython 
handheld 


Retro gaming, electronics, game 
programming, 3D printing 

It turns out Pico is great for game programming! 
K.G. shows you how to make the most of it. 
magpi.cc/123 


Hohn e ae 


magpi.cc/125 


>Commodore 64 emulation 
Retro gaming, software, emulation 

Raspberry Pi 400 is somewhat inspired by 1980s 
computers. Here’s how to make it run like one. 


magpi.cc/102 


«Pico DB9-to-USB joystick 
Retro gaming, programming, electronics 


Instead of daisy-chaining twelve adapters, how 
about creating a custom DBg to USB interface? 


FEATURE | Mig?t 


TV, an elderly DVD drive) or draw on my stash of reusable 
components (SBCs, microcontrollers, adapters with screw- 
down terminators).” 


Construction 

“You should be pretty confident that everything works 
before you assemble parts into a inconvenient location. Where 
possible, build the innards of the project on the bench/your 
sitting room floor before permanently soldering, screwing, 

or otherwise mounting them into place. It’s been three years 
and I’ve still not rewired some arcade machine buttons I 
connected to the wrong GPIO pins, even though it preys on me 
sometimes. (I put in a software workaround instead.) 

Finally: don’t be afraid of stickers, decals, stencils, and 
paint. They’re easier to position and reposition than you think, 
and any wonkiness is almost always completely invisible to 
everyone who isn’t you.” Ml 


RESOURCES 


RetroPie 

A retro gaming system built upon 
Raspberry Pi OS that makes it very 
easy to set up and play games. It’s 
used in many retro projects! 
retropie.org.uk 


Make your own 

video games 

K.G.’s guide on how to make games 
like in the old days. Many lessons 
can be brought forward to modern 
game development as well. 
magpi.cc/73 


Legal emulation 
information 

Our handy guide on legal emulation, 
along with links to repositories of 
completely legal and legitimate 
ROMs you can get for your machines. 
magpi.cc/legalroms 
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PiBoy XRS 


> Experimental Pi » magpi.cc/piboyxrs > £125/$150 


piece A more ergonomic handheld experience, the PiBoy XRS takes the 
Baca best parts of a lot of classic consoles, Rob Zwetsloot has a play 


face buttons, 
4 x shoulder 


buttons e were big fans of the PiBoy DMG, a four, and while that does mean two fewer face 
PORTS: Raspberry Pi 4-compatible handheld buttons, for the vast majority of games it’s a 
3.5mm audio in the shape of the classic Game Boy, layout we prefer. It turns out there’s a reason why 
jack, mini HDMI albeit with a few more buttons and an analogue handhelds went horizontal after the Game Boy. 
out, 2 x USB stick. It’s a great form factor for nostalgia 
2:0,2* USB... purposes. However, even Nintendo switched to Hook it up 
saa a horizontal format eventually. This brings us to Installing a Raspberry Pi 4 is very simple - with 
the PiBoy XRS which, while quite like the DMG the supplied screwdriver, you just need to take the 
DIMENSIONS: version, is definitely a superior product. eight screws off the back and then slot Raspberry 
162x193 Taking design notes from the original Game Pi into the GPIO pins. There’s some thermal paste 
an Boy, Neo Geo Pocket, and just about every portable for the processor, and an optional adapter for the 
DISPLAY: game system since the release of the Game Boy mini HDMI out. Four of the screws on the back- 
3.5" IPS LCD Advance, this updated kit also whacks ona second __ plate go through the mount holes on Raspberry Pi, 
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analogue stick for much improved playability. 
Instead of two shoulder buttons, there are now 


A There's easy access to the microSD port, and plenty of ventilation for Raspberry Pi 4 too 


making for a very elegant reassembly process. 

Power and headphone jacks are routed to the 
underside of the console, with rechargeable 
batteries, adding up to 5600 mAh, connected to 
that USB-C power port for hours of play time. 
The standard USB and Ethernet ports are then left 
open at the top of the XRS for easy, if not perhaps 
slightly awkward, access for peripherals and 
memory sticks. Those pop out of a fake cartridge 
slot, which is a nice little design touch, especially 
paired with the hand-detachable cover that allows 
you to change out microSD cards without having 
to get the screwdriver back out. 


Playing with power 

Like DMG, the whole package is solid and feels 
good to hold - we find some handheld Raspberry 
Pi consoles can feel a little flimsy and, while this 
may be a little heavier than those, we appreciate 
the added heft. 


Playing games is incredibly simple. Once the 
PiBoy image is installed, you can game basically 
straight away and as it’s the familiar RetroPie 
interface, you can easily customise it to your 
liking. Compatible games run smoothly thanks to 
the extra oomph of Raspberry Pi 4, and everything 
on the screen looked lovely as we played. Our kit 
came with the mini HDMI adapter, and we had 


M Once the PiBoy image is 
installed, you can game 
basically straight away 


no problems playing games on a bigger TV with it 
plugged in either - although, due to the graphical 
prowess of some games, it did look better on the 
smaller screen with a higher pixel density. 

Also, as it has RetroPie, it means you can install 
Steam Link, so it’s a pretty cool alternative to a 
Steam Deck. H 


A The joysticks remind 
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us of the smaller 
ones on the Switch 
Joy-Cons 


Access to the USB 
ports is handy however 
you play it. There 

are much fewer use 
cases for the Ethernet 
port, though 


Verdict 


The perfect retro 
handheld system 
is finally here, and 
you can even use 
it to comfortably 
play modern 
games as well. 


10 10 
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Plasma Stick 2040 W 
(Pico W Aboard) 


FEATURES: 

3 screw 
terminals (5V, 
ground, data), 
reset button, 
Qwiic/STEMMA 
QT port 


DIMENSIONS: 


67 x22 x12mm 


> Pimoroni » magpi.cc/plasmastick > £12/$12 


Light up your projects with this Pico W-powered 
NeoPixel controller. By Phil King 


ith a pre-soldered Pico W on board, the 
W Plasma Stick 2040 W is designed as an 


easy-to-use controller for addressable 


NeoPixels (aka WS2812B / SK6812 LEDs). Three 
screw terminals offer a simple and secure 
connection method for your LED strip’s wires. Note 
that if the strip has female connectors, as ours did, 
you may need female-to-male jumper wires. 

To get you up and running quickly, the Plasma 
Stick 2040 W is preloaded with Pimoroni’s own 
brand of MicroPython firmware, complete with a 
fair few example programs, including fire, rainbow, 
snow, and sparkle effects. These can easily be 
adapted to suit the number of LEDs in your strip. 
Alternatively you can code in C/C++, or flash Pico W 
with CircuitPython to make use of Adafruit’s LED 
Animation library. 


Plasma programming 
The MicroPython code examples are based around 
Pimoroni’s Plasma library, as used for the firm’s 


Verdict 


While you could 
always use a 
plain Pico W to 
control LED strips, 
the Plasma Stick 
makes it simpler 
and has the 
bonus of a Qwiic/ 
STEMMA QT port 
and reset button. 


8, 10 
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A The Plasma Stick uses the power of the RP2040 chip's PIO capability 
to drive LEDs at a high, flicker-free frame rate 


A Slightly longer than its 
pre-soldered Pico W, 
the Plasma Stick has 
screw terminals to 
connect an LED strip 


Plasma 2040 controller — although unlike that 
board, the Plasma Stick can’t be used with DotStar/ 
APA102 LEDs. The colour of individual LEDs can 


M Pico W's Wi-Fi connectivity 
ddds extra possibilities for 
your lighting projects @ 


be set using RGB or HSV, along with the overall 
brightness level. 

Just connect to a computer via USB to power the 
Plasma Stick’s Pico W and run/edit the code. As 
usual, to get a program to run automatically on 
boot-up, save it as main.py and then connect a 
standard USB power source, such as a power bank. 

Pico W’s Wi-Fi connectivity adds extra 
possibilities for your lighting projects. Code 
examples include responding to the current 
Cheerlights colour (see @cheerlights on Twitter) or 
weather conditions sourced from the web. You can 
also take readings from any sensor attached to the 
Plasma Stick’s Qwiic/STEMMA QT port. 


AN INTRODUCTION 17'O 


CsGul 


PROGRAMMING 


> All you need to know 
WN to write simple 

<o programs in C and 
start creating GUIs 


Inside: 


= Create simple command-line C programs 
& I = Control flow with conditions and loops 
= Handle variables, strings, and files 


p RO G RAMMI ING = Design graphical user interface 


applications in C 


AN INTRODUCTION == 


= Handle user input with buttons and menus 


= Use advanced UI features such as data 


Simon Long ; 
stores and dialogs 


£10 with FREE 
worldwide delivery 


Buy online: magpi.cc/cgul 
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Inky Frame 4.0 
(Pico W Aboard 


DISPLAY: 
4.01-inch e-ink, 
640x400, seven 
colours 


FEATURES: 
Pico W, 5 x user 
buttons, reset 
button, LEDs, 
microSD card 
slot, breakout 
header, 2 x 
Qwiic/ STEMMA 
QT ports, 2 x 
metal legs 


DIMENSIONS: 


102.8 x 96.7 mm 


Verdict 


A classy colour 
e-ink display 
whose Wi-Fi 
connectivity 
greatly extends 
its possible uses, 
including as a 
digital photo/ 
art frame, life 
organiser, or 
low-power smart 


home dashboard. 


9, 10 
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> Pimoroni >» magpi.cc/inkyframe4 >» From£70/S$71 


This slick colour e-ink display benefits from 
Pico W's wireless connectivity. By Phil King 


screens, the Inky Frame 4.0” features a 
4-inch, 640x400, seven-colour display that 
offers superb detail. The board is based around 
a Raspberry Pico W pre-soldered to the rear. As 
well as giving it Wi-Fi connectivity, this increases 
portability when used with a battery pack. 

Also on the rear, there’s a handy reset button, 
microSD card slot (for extra storage), two Qwiic/ 
STEMMA QT ports, a JST-PH battery connector, and 
an extension header (including six GPIOs). 


T he latest in Pimoroni’s Inky range of e-ink 


M |t can even be put into a 
Super deep sleep mode 
with Pico W shut down 


Y 


x Ns 
INKY FRAME (40 


Five user 
buttons are located 
on the front, each 
with an LED, with two 
more LEDs at the top to 
indicate activity and wireless 
connection. Two metal legs 
supplied) can be used to stand up the board. 


A With 640x400 
pixels packed into 
a 4-inch screen, 
the Inky Frame has 
excellent definition 
for displaying images 


Refreshing stuff 

The Inky Frame comes preloaded with Pimoroni’s 
brand of MicroPython firmware, including the 
PicoGraphics display library and several code 
examples. As soon as you connect it to a computer 
via USB, it’ll start a screen refresh which takes 
25-30 seconds - typical for this kind of multicolour 
e-ink display. 

By default, it auto-runs a launcher menu 
with five example programs. However, to run 
them you’ll first need to stop the launcher in 
Thonny and create a secrets.py file with your 
Wi-Fi credentials (see Pimoroni’s Getting Started 
guide: magpi.cc/inkyframeguide). 

An optional accessories pack adds a 3xAA battery 
pack (with batteries), Velcro square to attach it to 
back of board, 16GB microSD card, and micro USB 
to USB cable. You could use a LiPo battery instead, 
but the board can’t charge it. Still, it uses a small 
amount of power while refreshing, and can even be 
put into a super deep sleep mode with Pico W shut 
down - and reawakened by the real-time clock, 
buttons, or a trigger pin on the extension header. HI 


<< Onthe rear you'll find Pico W, along with a microSD 
slot, extension header, battery connector, and two 
Qwiic/STEMMA CT ports for breakout sensors 
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FROM THE MAKERS OF MagPi THE OFFICIAL RASPBERRY PI MAGAZINE 
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10 Amazing: 


Portable 
Projects 


Carry Raspberry Pi around with you wherever 
you go with these cool builds and kits 


really need big pockets either, and Raspberry Pi Zero 

and Pico will even fit in your wallet! Now that’s small. 
Being so easy to take with you, that begs the question, what 
are the best ways to carry it around? We have ten answers 
for you. 


2 aspberry Pi is basically pocket-sized. You don’t even 


4 Mini laptop 


Palm-sized Raspberry Pi 


This DIY build is very cheap and very good as well - it runs ona 
Raspberry Pi after all! Upgrade it with a Raspberry Pi Zero 2 W and it’s 
even more powerful. 


magpi.cc/74 
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4 Becca Cam 


Raspberry Pi SLR 


Built into an old SLR camera, this Raspberry Pi digital camera 
gets to use some of the benefits of an old SLR. Imagine this with 
a Camera Module 3... 


magpi.cc/beccacam 


> PiBoy DMG kit 


Retro handheld 


We reviewed the successor to this kit in 
this issue, the XRS. However, the original 
is stillan excellent handheld that we take 
around with us to this day. 


magpi.cc/piboydmg | £113 / $140 


v CutiePi tablet 


Tablet with handle 


This Compute Module 4-powered tablet is very practical and 
useful, and the fancy handle can also be used to prop it up in 
multiple ways. 


cutiepi.io | £185 / $229 


MéigPi 


You could take your lunch in a lunchbox, 
or you could take Super Street Fighter II 
Turbo and find out who is the strongest 
world warrior. 


This wireless cloud server build on a Raspberry Pi Zero W isa 
great way to take the cloud with you for work or vacation. 


This suitcase is fit for the 1980s 
cyberpunk fantasy of your dreams, 
complete with Raspberry Pi desktop 
and the ability to play retro games. 


This small, yet powerful, 
Raspberry Pi-powered 
laptop is also great for 
learning electronics with, 
as it has full GPIO access. 


This is technically portable, especially if you get the smaller one, or even just 
get the plug-and-play version. It’s a great way to game on the go. 


We have built this in the mag before, but the original build is an 
excellent mini-development Raspberry Pi you can take anywhere. 
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Learn Building and Making 


Combine your love of tech with some amazing making, suggests Rosie Hattersley 


[ Kev Robots 


Kevin McAleer 


Price: 
free 


kevsrobots.com 


We’ve been having quite the 
love-in with Kevin recently, 
featuring his sterling robot- 
making and MicroPython 
work in The MagPi (see his 
Cyberdog harness: magpi.cc/ 
cyberdog) and profiling him in 
a recent HackSpace (magpi.cc/ 
kevinmcaleerhs). Essentially, 
if you want to learn about how 
to design and create quirky 
robots from someone who 

has learned and blogged as 
he’s gone along, and are also 


keen to see the possibilities of 
coding with MicroPython with 
a view to coming up with your 


~ WIFI SCANNER 


own makes, head to Kevin’s 
website or tune in to his weekly 
YouTube broadcasts. H 


Get your making imagination 
working overtime 


How to Run a TJBot Workshop 


-_< woe 
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RASPBERRY PI PROJECTS 
SITES 

We're absolutely blowing our own 
trumpet here: we're very proud of 
the Projects section of Raspberry 
Pi’s website, where you can search 
by type of creative project and 

the experience level that might 
be needed. 

> magpi.cc/projects 


TOM’S HARDWARE 

Our friends at Tom's Hardware 
regularly feature great Raspberry Pi 
builds, and their latest rundown of 


projects worth tackling - and why 

- is well worth browsing while you 
decide what you'd like to build and 
what's involved. We particularly like 
the Pico-based radio transmitter: 

> magpi.cc/tomsprojects 


INSTRUCTABLES 

A super site for creative makes of all 
stripes, Instructables offers details of 
how to tackle dozens of Raspberry Pi 
projects, and even has instructions 
for teachers, such as this set of TJBot 
robot resources: magpi.cc/runtjbot. 
> instructables.com 
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SPBERRY pr 
ROROJECTS 


Raspberry Pl 
Projects For Kids 


i Dan Aldred 


Although this book, published 
by No Starch, is ideal for 
getting youngsters to be 
creative with Raspberry Pi, 
there’s every chance you’ ll 
also find something you want 
to build yourself - whether a 
radio receiver, a music box, 

or a wildlife tracker. There’s a 
helpful introduction to Python 
programming too, which will 
be invaluable if coding is new 
to you or your offspring, or 
you’re making the switch from 
Scratch or another visual coding 
method. The nicely laid out 


Price: 
£18/$20 


magpi.cc/raspiforkids 


FOR KIDS 


FT’, 
4p PLAYER, MOD MINECRA 
ce RADIO WAVES, AND MORE! 


coral 


Teaching 


resources 


Tasked with helping 
younger tinkerers 
achieve? Read on 


CODE CLUB 

Code Club offers lots of 

fun project ideas, with full 
instructions for both makers 


and anyone helping them 
projects and accessible, but 
not too simple approach, give 
it cross-generational appeal, 
which sounds like the perfect 
excuse to buy it for the kids, 
although it’s also an informative 
treat for you. Hl 


achieve their creative goals. 
Look out for items labelled 
as part of the Physical 
Computing Curriculum. 

> magpi.cc/ 
codeclubprojects 


PROJECT ARTHUR 


Project Arthur combines 


HackSpace Wearable 


Tech Projects and 
The Book of Making 2 


HackSpace HackSpace magazine is devoted 
to all kinds of making and 

Price: creativity with two pertinent 

£10/$10 books: Wearable Tech Projects 

magpi.cc/ and The Book of 

Woursblepiciects Making Volume 2. <o PR 

magpi.cc/ \s 


Although these don’t 
focus exclusively on 
Raspberry Pi, each 
publication provides 
plenty of details and 
inspiration, along with 
GitHub code downloads 
so you can replicate each 
project, or adapt an idea to 
make it your own. Wearable 
Tech Projects invites you to 
make, sew, and wear items 
you’ve stitched and coded, 


bookofmaking 


paper-building with Raspberry 
Pi Zero W tech to track the 
International Space Station 
and light up when it’s 
overhead. A bonus is that it’s 
named after the satellite dish 
at Goonhilly in Cornwall, site 
of the recent space satellite 
launch attempt. 

including replica sci-fi costumes > apolloS0.co.uk 
and bling-laden outerwear 

and jewellery. Hl 


MARIA AWARD-WINNING 
HUMAN 


Something to catch the eye 


ry ACKERS 


of manga fans and other cool 
customers, Maria is a pseudo- 
holographic personal assistant 
to give Alexa a run for her 
money. As well as being a 
quirky but engaging Raspberry 
Pi project, Maria's features can 
be extended in multiple ways, 
customising music, weather 
and gossip feeds, depending 
on creators’ preferences. 
> maria. 
awardwinninghuman.com 
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P From last issue, Photon 
got a big response online 
from photographers 
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Meet two creatives who admire a minimialist gesthetic and enjoy making 
useful things from ‘older’ technology 


> Name Vanessa Bradley and Martin Spendiff | >» Occupation Photography 


> Community role Makers | 
ave you ever just wanted 
to get away? Vanessa 


Al Bradley and Martin 
Spendiff did, and a decade ago 
they moved to Switzerland. 
After a few years of working 


in IT for big corporations, they 
then made another change to 


> URL veeb.ch 


photography, with a side of 
making to go with it. 

“We've always been early- 
adopters and interested in 
getting stuff to do new things 
that are a touch outside of 
the originally intended use- 
case,” the two tell us. “We also 
benefited from open-source 
tools when we were using Linux 


wa(aaaaa)y back in the 1990s, so 
we are keen to share what we do 
in case anyone finds it useful.” 


When did you first learn about 
Raspberry Pi? 

In 2012, just from being aware 
of new things in tech. The idea 
of a single board computer at 
such a low price was compelling. 


INTERVIEW | Magri 


A This clock required a Pico 


to give it a signal it could 


Since then, they have always 
been dotted about running 
various things like Pi-hole, 
Nextcloud, and RetroPie etc. 
Raspberry Pi Pico was a real 
revelation, as it suddenly made 
it easy to imagine bits of code 
living outside of the confines of 


and send us photos of them 
using them to do exotic kinds 

of photography. An honourable 
mention has to go to the LED 
physical progress bar that we 
made (magpi.cc/LEDprogress). 
It’s a super-simple build that 
uses Google Calendar and a light 


M The idea of a single board computer 
at such d low price was compelling @ 


an operating system that did all 
sorts of other things. 


Where do you get your 

ideas from? 

Laziness, a refusal to stop using 
things that do something well, 
or a sentence that starts with ‘it 
would be nice if...’. There’s also 
a thread of nostalgia that runs 
through a lot of things we end 
up doing. 


What is a favourite thing you’ve 
made with Raspberry Pi? 

The incident light meter, Photon. 
People occasionally make one 


strip to make something that is 
really handy to glance at. It’s 
now an indispensable feature in 
our studio. 


Where can people follow 
your stuff? 

Most things we do end up 
going into a YouTube 
video (magpi.cc/ytveeb), 
as well as onto GitHub 
(github.com/veebch). 

In a very Internet 1.0 way, 
we also add things to our 
own ‘blog’ (veeb.ch/notes) 
(do people even say ‘blog’ 
any more?) Hl 


no longer hear 


A Asimple, but useful, solution for making sure that your plant is watered 


The first project that we 
showcased from the 
two in the magazine, an 
automation throwback 
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i» caitlinsdad 
2 J 


Giant Thermometer scarf. Temperature, humidity 
readings and fire. 


0:29 1,079 views 


ry 4 Extreme Kits K @ExtKits@mstdn.social 
4s 


Amazing projects direct from our Twitter! 


More development for the Pico-puter. 


very Monday we ask the question: have you Currently two case styles, and Software to emulate 

made something with a Raspberry Pi over an RC2014, PDP11 and a BBS terminal(telnet) 

the weekend? Every Monday, our followers 
send us amazing photos and videos of the things 
they have made. 

Here’s a selection of some of the awesome 

things we got sent this month - and remember 
to follow along at the hashtag #MagPiMonday! 


More to come... 


Better check your scarf to see if you need 
to wear it. Let's hope it doesn't lie so you 
don't leave it at home 


This tiny computer is very cute. We kinda 
want one 3g Pierre-yves Baloche 


We love a good Raspberry Pi Camera 
Module project - this is definitely up there 


This has to be seen to be appreciated - Happy ! Great weekend while reading 
unfortunately headphones won't make it the #126 issue and working on my 

any Hess NOlsy with its modular design to use the latest 
We always want to see pictures of critters camera module 3. As no hardware modification are 


and creatures caught with Raspberry Pi required,| got started on the new software to get 


Archie the owl has some competition most of this incredible enhancement @ 


it seems = 
While there were some Super Mario Bros. ’ 
Arcade machines, they weren't quite as a 
coolas this one = KEEEE 


We already have project plans ourselves 
for next Christmas... 


We like how compact this robot is 
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r By Simon Prickett |) | simonprickett.dev 


&) Toni Auspuh 
Flip dot bus sign flappy bird needs wiring up to an 


arcade button to flap the bird. Written in | installed a camera in a bird box last year, but | had 
running on a Pi 3 with a USB to RS485 adapter. only short time visitors. This year | will try a bigger, 
more comfortable bird box. :) 


Kevin McAleer @ Robot Maker 


Happy ! 

This weekend I’ve been working on Bubo-2T - the 

steampunk owl robot that can take pictu using the 
mera module 3 wid me hand and 

gesture tracking with CVZone and then toot or tweet 

it out. 


Hi 4 

| build an arcade Machine for my son (6 years old). It 
took me not just this weekend. It took me nearly a 
year for the wood working part. It's based ona 
Raspberry Pi 3B with RetroPie. My son loves it. | hope 


Its so much fun, and look how cute too +s 
you like it too. 


First post. Finally finished this... j 
in time for next Christmas. North pole sign with 


; ‘ ; , i built a Raspberry Pi 4-robot 
neopixels embedded in the post. Controlled with a 


Ae 9 with light detection and ranging supported by 
Raspberry Pi Pico. Cheers! [sm weekly YouTube show ,, LEARN ROS WITH 


theca peat Boe ey 


Il 0:37 763 views 
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amJam returns! 


Cambridge's premier Raspberry Jam is back this April 


get a little more open, Raspberry Jams 

and events are making their way back to 
physical spaces, and this includes the venerable 
CamJam (camjam.me) on Saturday 22 April. 

The MagPi regular Brian Corteil has taken the 
reigns for its return and promises that “There 
will be a series of talks, organised workshops for 
both the Raspberry Pi and Pico, plus a ‘show and 
tell’ area for people to show off their projects. We 
are fully inclusive of technology: if your project is 


based around an Arduino, micro:bit, or something 
else, we would still love to see it!” 
It’s being held at Makespace, a fantastic 
community workshop in Cambridge, and kids 
; ; 7 P CamJam is one of the oldest La} 


enter free. Find out more info at the Eventbrite : 
: 4 Raspberry Jams, running in 
page here: magpi.cc/camjam23. the home of Raspberry Pi 


Affordable bilingual 
computing 


Student Conall Kavanagh presents a 
solution for Irish and English speakers 


dd M y hypothesis is that there are serious 


G reat news folks! As the world starts to 


V Raspberry Pi and Raspberry Pi OS can make 
for cheap computing for bilingual learning 


failings in the provision of technology 
in the Irish second-level education 
sector,” reads Conall’s report ‘Low-cost bilingual 
computing for the education sector’. He presented 
his project at the BT Young Scientist and 
Technology Exhibition (btyoungscientist.com). 
“Much of the technology that is recommended 
for use is extremely expensive,” Conall continues. 
“This makes it unaffordable for many Irish 
families, and puts some students at a severe 
disadvantage compared to more affluent peers.” 
Conall presented a specialised version of 
Raspberry Pi OS on a Raspberry Pi Zero 2 W as part 
of his solution to the problem, complete with a 
compact dock. Hl 
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XGO 2 


According to the website, XGO 2 is the first Raspberry Pi 
robotic dog with an arm - and by that they mean a robot 
arm attached behind the head, along with its four other 
robotic limbs. 

“XGO 2 is a desktop-sized Al quadruped robot with 12 
degrees of freedom and a gripper powered by Raspberry 
CM4 for Al edge computing applications, which can achieve 
omnidirectional movement, six-dimensional posture 
control, posture stability, and multiple motion gaits.” 


kck.st/40fpLzG 


ARMedOne 


The ARMedOne is a compact and modular carrier board for 
up to 28 compute modules, using a standardized E-ATX form 
factor. The Kickstarter page claims it can handle every type of 
Compute Module which uses SODIMM-Pins, which includes 
Raspberry Pi Compute Modules, among others. 


kck.st/3WT29hS 
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Intuitive HMI Design 


MEET US AT 
Embedded World 2023 


WE WagPi | YOUR LETTERS 


Top antenna tips 


I was interested to see your article on flight tracking. 
This is something I’ve been experimenting with for about four years. 
You mention, as a top tip, that antenna position is key. My experiments 
prove this. Having a clear line of sight, and a good antenna is very 
important to pick up ADS-B signals... with a general purpose discone 
antenna on my garden shed, with 5m of cable between the antenna and 
the SDR. It manages to pick up less than 20 aircraft, with a maximum 


A Antenna placement is very 
important, as lan points out 


g2 | magpicc | Your Letters 


range of 120km to the north and 
50km to the south. 

The screenshot [pictured] 
is using an ADS-B specific 
antenna, at rooftop height and 
with 1m of cable between the 
antenna and SDR. The SDR is 
mounted in a waterproof box on 
the antenna pole, and connects 
to an indoor Raspberry Pi via a 
10m active USB cable. This picks 
up over a 100 aircraft, with a 
maximum range of 400km. 

Living near Birmingham, I 
can ‘see’ aircraft over a large 
part of the country, as long as 
they are above the horizon. A 
plane at 40,000 feet has a radio 
horizon of about 450km. So, 
I can see planes flying over 
London, but not landing at 
Heathrow because they’re below 
the horizon. 

Another part of my 
experimentation has been to use 


a second Raspberry Pi to take screenshots every 
few seconds, then stitch them together to make a 
time-lapse movie. It was very interesting to see the 
effect of the pandemic on flight movements. Nearly 
all passenger planes stopped, but there were still a 
large number of freight flights taking place. 

Rather than use Flightradar24, or other 
packages that send data to a cloud-based server, I 
keep the data in-house. I use Dump1090 (I believe 
Flightradar24, and most of the other packages, 
use Dump1090 internally) to control my SDR USB 
stick, and use Virtual Radar Server to generate the 
map, with aircraft plotted on it using Dump1090’s 
data stream. Both packages are on the same 
Raspberry Pi. I can then web-browse to my Pi 
from any device on my home network to see 
what’s in the air. 

I find it quite interesting to see what’s up 
there, and I’ve learnt a few things. For example, 
East Midlands Airport is very busy at night with 
freight aircraft coming in from the USA. I used to 
think it was mainly summer holiday flights. 


lan via email 


Thank you for your extra information about this! 
Keeping the data in-house is a great idea, and the 
time-lapse is a cool concept too. Hopefully, any 
readers who read the original article, and were 
inspired to make their own, can use this knowledge 
to do some extra bits to theirs. 
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We interview the makers of the excellent Photon on page 86 


I think there’s an error in issue 126 that I’m 
reading now. 

In the Contents, it says project PHOTON on page 26 
(I’m very interested because photography is one of 
my greatest interests), but on this page the project is 
‘Raspberry Pi Backpack’, and Photon does not appear in 
the magazine. 


Roberto via email 


There was a slight error with the PDF for issue 
126 when we first published the magazine, which 
has since been updated. Print issues have 
the project on the correct page, but if you 
downloaded the PDF in the first couple of 
days, you may need to re-download it. 
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RASPBERRY PI 
DEBUG PROBE 


The new Raspberry Pi Debug 
Probe Is built on RP2040 and 
can help you to debug your 
Raspberry Pi Pico projects in 

a way that a computer lacking 
GPIO pins cannot. We have 
ten of the probes to give away. 


Head here to enter: magpi.cc/win | Learn more: magpi.cc/debugprobe 


Terms & Conditions 


Competition opens on 22 February and closes on 30 March. Prize is offered to participants worldwide aged 13 or over, except employees of Raspberry Pi Ltd, the prize supplier, their 
families, or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any publicity generated 
from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants’ details will remain strictly 
confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange delivery. Any 
winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, or associated 
with, Instagram, Facebook, Twitter or any other companies used to promote the service. 


Competition | magpicc | 95 


RETRO GAMING 


ZW TH 


RASPBERRY Pl 


Jae l= (3) (ENN 


Retro Gaming with Raspberry Pi shows you how to set up a 


" Raspberry Pi to play classic games. Build your own games console 


or full-size arcade cabinet, install emulation software and download 
classic arcade games with our step-by-step guides. Want to make 
games? Learn how to code your own with Python and Pygame Zero. 


=m Set up Raspberry Pi for rr 
OF 


retro gaming i) FROMTHE aS 


m Emulate classic 
computers and consoles 


m Learn to code your 
own retro-style games } 


mw Build a console 
handheld, and full-size 
arcade machine 


BU ONIEINIE: 
magpi.cc/store 
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Artificial Artists 


Can machine-learnin 
put to better use? 


rtificial Intelligence is still 
A in the news, and for good 

reason. There are incredible 
strides appearing in the world 
of computer- generated images, 
video and text. Generative art 
and video is based upon an open- 
source technology called Stable 
Diffusion, which can create any 
artwork you desire based on text 
prompts. You can test it out online at 
stablediffusionweb.com if you want 
to paint the cheese moon landing, 
or the distracted boyfriend meme 
by Picasso. The open-source Stable 
Diffusion 2 GitHub code is found at 
magpi.cc/stablediffusiongit. 

If you think artists have it bad, 
then spare a thought for your lonely 
writers. We’re staring down the 
barrel of ChatGPT and Google’s 
response, Bard. 


The creative mill 

As Rob pointed out last month 
(magpi.cc/126), ChatGPT’s copy is 
generously described as ‘hit-and- 
miss’. A more accurate assessment 
would be: “dumber than a tall person 
hopping at the very peak of Dunning- 
Kruger’s mount stupid” (magpi.cc/ 
mountstupid). It is convincing though 
and a lot of online copy is equally 
misguided. Which may be the point. 
Getty Images is suing Stable Diffusion 
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for $1.8-trillion because: “It is Getty 
Images’ position that Stability AI 
unlawfully copied and processed 
millions of images protected 

by copyright.” 

Beyond copyright and clarity, there 
are legitimate ethical concerns. Since 
last month tech wizards with flexible 
morals have already got around 
safeguards by getting ChatCPT to 
role-play as a different AI called 
‘DAN’ which stands for ‘Do- 
anything-Now’. 

Al can create anything as dark as 
the mind can conjure. A quick traipse 
through the internet will reveal some 


@ Machines should 
work; People 
should think @ 


very dark thoughts indeed. 


Positive thoughts 
It’s easy to knee-jerk against this 
advancement. I love what I do, but 
technology should replace people. I 
can quite happily sit on a beach and 
read poetry to my friends while 
computers do all the work. 

The IBM/Jim Henson’s Machines 
Should Work; People should think 
speech from 1967 comes to mind 


g technology can be 
By Lucy Hattersley 


(magpi.cc/machinesshouldwork). 
Computers are supposed to take out 
the trash, clean the floor, do the 
dishes and the washing up and we 
(the humans) are supposed to sit on 
the beach and share our stories, make 
up music, and paint pictures. 

The future of machine-learning 
technology is, I suspect, in more 
mundane, but ultimately useful, 
applications. The robot vacuum 
cleaner that picks up the socks from 
your ‘floordrobe’ and puts them back 
in a drawer (or in the wash) is 
ultimately far more valuable to us 
than one that paints selfies. 

Of course, that machine would 
probably need wheels and arms and a 
mechanical nose alongside the AI 
smarts to know what scruffy socks 
look like. Oh and look, scientists from 
Tel Aviv are working on a robot with a 
biological nose (magpi.cc/bionose). 
Of course, it has Raspberry Pi inside. 

This is the real stuff of the future. 
Where hardware and software and 
robotics and Al-smarts come together 
to do useful stuff while we all chill. Hl 


Lucy Hattersley 


Lucy is editor of The MagPi and currently 
getting Al to paint a picture of her cat 
fetching her a cup of tea in the morning. 
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HiPi.io 


HIGHPI PRO 


-— —— The new case from the HiPi.io team ———————-- 


® Rapid tool-free assembly and disassembly ® Secure microSD card cover 
@ Large internal volume for HATs @ VESA mount support 


®@ Compatible with Pi 2/3/4 ® Molding-configurable output ports 


e Multiple lid options customizable for volume orders 
@ Passive & Active Cooling options @ Printed logo for your branding 


Available at these great Pi stores: 


Li 4 ew 
#£PiShop.us (*fPiShop.ca {*$ PiShop.mx C)zpinut PrSnoe.cn Welectron. 


Contact your favorite Pi store if it’s not listed here 


HIPI.10 


PIKVM 


Manage your servers or 
workstations remotely 


A cost-effective solution for data-centers, 
IT departments or remote machines! 


PiKVM HAT 


for DIY and custom projects Pre-Assembled version 


e Real-time clock with rechargeable super capacitor e@ OLED Display e Bootable virtual CD-ROM 
& flash drive © Serial console ® Open-source API & integration ® Open-source software 


Available at the main Raspberry Pi resellers 


H )RPishop.cz Welectron. lektorsto rit | «2 
Vee docavatet Raspberry Pt 


PrSnoe.ch = @zpinut #€ PiShop.us ( Pishop.mx 


Scere 


TR 


Reseller suggestions and inquiries: 


wholesale@hipi.io 


